From 16283884180943d965f2f796dc6f11fbeca9eb98 Mon Sep 17 00:00:00 2001
From: "Silc Lizard (Tokage) Renew"
<61938263+TokageItLab@users.noreply.github.com>
Date: Sun, 26 May 2024 10:46:12 +0900
Subject: [PATCH] Add Skeleton modifier design article
---
.../design-of-the-skeleton-modifier-3d.md | 237 ++++++++++++++++++
.../design-of-the-skeleton-modifier-3d.webp | Bin 0 -> 874124 bytes
.../add_skeleton_modifier.webp | Bin 0 -> 15958 bytes
.../bones_enum.webp | Bin 0 -> 9046 bytes
.../custom_modifier.mp4 | Bin 0 -> 1518496 bytes
.../different_process_orders.webp | Bin 0 -> 5426 bytes
.../mod.webp | Bin 0 -> 68998 bytes
.../modified_pose.webp | Bin 0 -> 208622 bytes
.../modifier_callback_mode_process.webp | Bin 0 -> 7374 bytes
.../register_custom_modifier.webp | Bin 0 -> 18782 bytes
.../skeleton-modifier-3d-demo-project.zip | Bin 0 -> 2551445 bytes
.../skeleton_modifier_process.webp | Bin 0 -> 82342 bytes
12 files changed, 237 insertions(+)
create mode 100644 collections/_article/design-of-the-skeleton-modifier-3d.md
create mode 100644 storage/blog/covers/design-of-the-skeleton-modifier-3d.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/add_skeleton_modifier.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/bones_enum.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/custom_modifier.mp4
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/different_process_orders.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/mod.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/modified_pose.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/modifier_callback_mode_process.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/register_custom_modifier.webp
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/skeleton-modifier-3d-demo-project.zip
create mode 100644 storage/blog/design-of-the-skeleton-modifier-3d/skeleton_modifier_process.webp
diff --git a/collections/_article/design-of-the-skeleton-modifier-3d.md b/collections/_article/design-of-the-skeleton-modifier-3d.md
new file mode 100644
index 0000000000..ceb854e342
--- /dev/null
+++ b/collections/_article/design-of-the-skeleton-modifier-3d.md
@@ -0,0 +1,237 @@
+---
+title: "Design of the Skeleton Modifier 3D"
+excerpt: "Skeleton bone update process is reworked to add SkeletonModifier3D for modifying the Skeleton."
+categories: ["progress-report"]
+author: Silc Renew
+image: /storage/blog/covers/design-of-the-skeleton-modifier-3d.webp
+date: 2024-06-01 00:00:00
+---
+
+
+
+A new node called `SkeletonModifier3D` will be added in Godot 4.3. It is to animate `Skeleton3D` outside of `AnimationMixer` and is the base class for several existing nodes.
+
+Thus, we add the deprecated flag on some old properties with "override" in `Skeleton3D`.
+
+- `set_bone_global_pose_override()`
+- `get_bone_global_pose_override()`
+- `get_bone_global_pose_no_override()`
+- `clear_bones_global_pose_override()`
+
+# Did the pose override design have problems?
+
+
+
+Previously, we recommended using the property `global_pose_override` when modifying the bones. This was useful because the original pose was kept separately, so blend values could be set, and bones could be modified without changing the property in `.tscn` file. However, the more complex people's demands for Godot 3D became, the less it covered the use cases and became outdated.
+
+The main problem is the fact that "the processing order between `Skeleton3D` and `AnimationMixer` is changed depending on the `SceneTree` structure`.
+
+**For example, it means that the following two scenes will have different results:**
+
+
+
+If there is modifier such as IK or physical bone, in most of cases, it needs to be applied to the result of the played animation. So they need to be processed after the `AnimationMixer`.
+
+In old skeleton modifier design with bone pose override you must place those modifiers below the `AnimationMixer`. However as scene trees become more complex, it becomes difficult to keep track of the processing order. Also the scene might be imported from glTF and cannot edit without localization, so managing node order becomes tedious.
+
+Moreover, if multiple nodes use bone pose override, it breaks the modified result.
+
+**Let's imagine a case in which bone modification is performed in the following order:**
+
+```
+AnimationMixer -> ModifierA -> ModifierB
+```
+
+Keep in mind that both `ModifierA` and `ModifierB` need to get the bone pose that was processed immediately before.
+
+The `AnimationMixer` does not use `set_bone_global_pose_override()`, so it transforms the original pose as `set_bone_pose_rotation()`. This means that the input to `ModifierA` must be get from the original pose with `get_bone_global_pose_no_override()` and the output must be get from override with `get_bone_global_pose_override()`. In this case, if `ModiferB` wants to consider the output of `ModiferA`, both the input and output of `ModifierB` must be override with `get_bone_global_pose_override()`.
+
+Then, can the order of `ModifierA` and `ModifierB` be interchanged?
+
+--The answer is "NO".
+
+Because `ModifierB`'s input is now `get_bone_global_pose_override()` which is different from `get_bone_global_pose_no_override()`, so `ModifierB` cannot get the original pose set by the `AnimationMixer`.
+
+As I described above, the override design was very weak in terms of process ordering.
+
+# How the new skeleton design to work with SkeletonModifier3D?
+
+`SkeletonModifier3D` is designed to modify bones in the `_process_modification()` as virtual method. This means that if you want to develop a custom `SkeletonModifier3D`, you will need to modify the bones within that method.
+
+`SkeletonModifier3D` does not execute modifications as stand alone, but is executed by the parent of `Skeleton3D`. By placing `SkeletonModifier3D` as a child of `Skeleton3D`, they are registered in `Skeleton3D`, and the process is executed only once per frame in the `Skeleton3D` update process. Then, **the processing order between modifiers is guaranteed to be the same as the order of the `Skeleton3D`'s child list**.
+
+Since `AnimationMixer` is applied before the `Skeleton3D` update process, `SkeletonModifier3D` is guaranteed to run after `AnimationMixer`. Also, they do not require `bone_pose_global_override`; This removes any confusion as to whether we should use override or not.
+
+**Here is a SkeletonModifier3D sequence diagram:**
+
+
+
+Dirty flag resolution may be performed several times per frame, but the update process is a deferred call and is performed only once per frame.
+
+At the beginning of the update process, it stores the pose before the modification process temporarily. When the modification process is complete and applied to the skin, the pose is rolled back to the temporarily stored pose. This performs the role of the past `bone_pose_global_override` which stored the override pose separate from the original pose.
+
+By the way, you may want to get the pose after the modification, or you may wonder why the modifier in the later part cannot enter the original pose when there are multiple modifiers.
+
+We have added some signals for cases where you need a pause at each point in time, so you can use them.
+
+- AnimationMixer: mixer_applied
+ - Notifies when the blending result related have been applied to the target objects
+- SkeletonModifier3D: modification_processed
+ - Notifies when the modification have been finished
+- Skeleton3D: skeleton_updated
+ - Emitted when the final pose has been calculated will be applied to the skin in the update process
+
+Also, note that this process depends on the `Skeleton3D.modifier_callback_mode_process` property.
+
+
+
+For example, in a use case that the node uses the physics process outside of `Skeleton3D` and it affects `SkeletonModifier3D`, the property must be set to `Physics`.
+
+Finally, now we can say that `SkeletonModifier3D` does not make it impossible to do anything that was possible in the past.
+
+# How to make a custom SkeletonModifier3D?
+
+`SkeletonModifier3D` is a virtual class, so you can't add it as stand alone node to a scene.
+
+
+
+Then, how do we create a custom `SkeletonModifier3D`? Let's try to create a simple custom `SkeletonModifier3D` that points the Y-axis of a bone to a specific coordinate.
+
+## 1. Create a script
+
+Create a blank gdscript file and extends `SkeletonModifier3D`. At this time, register the custom `SkeletonModifier3D` you created with the `class_name` declaration so that it can be added to the scene dock.
+
+```gdscript
+class_name CustomModifier
+extends SkeletonModifier3D
+```
+
+
+
+## 2. Add some declarations and properties
+
+If necessary, add a property to set the bone by declaring `@export_enum` and set the `Skeleton3D` bone names as a hint in `_validate_property()`. You also need to declare `@tool` if you want to select it in the editor.
+
+```gdscript
+@tool
+
+class_name CustomModifier
+extends SkeletonModifier3D
+
+@export var target_coordinate: Vector3 = Vector3(0, 0, 0)
+@export_enum(" ") var bone: String
+
+func _validate_property(property: Dictionary) -> void:
+ if property.name == "bone":
+ var skeleton: Skeleton3D = get_skeleton()
+ if skeleton:
+ property.hint = PROPERTY_HINT_ENUM
+ property.hint_string = skeleton.get_concatenated_bone_names()
+```
+
+The `@tool` declaration is also required for previewing deformations by `SkeletonModifier3D`, so you can consider it is required basically.
+
+
+
+## 3. Coding calculations of the modification in `_process_modification()`
+
+```gdscript
+@tool
+
+class_name CustomModifier
+extends SkeletonModifier3D
+
+@export var target_coordinate: Vector3 = Vector3(0, 0, 0)
+@export_enum(" ") var bone: String
+
+func _validate_property(property: Dictionary) -> void:
+ if property.name == "bone":
+ var skeleton: Skeleton3D = get_skeleton()
+ if skeleton:
+ property.hint = PROPERTY_HINT_ENUM
+ property.hint_string = skeleton.get_concatenated_bone_names()
+
+func _process_modification() -> void:
+ var skeleton: Skeleton3D = get_skeleton()
+ if !skeleton:
+ return # Never happen, but for the safety.
+ var bone_idx: int = skeleton.find_bone(bone)
+ var parent_idx: int = skeleton.get_bone_parent(bone_idx)
+ var rest: Transform3D = skeleton.global_transform * (skeleton.get_bone_global_pose(parent_idx) if parent_idx != -1 else Transform3D()) * skeleton.get_bone_rest(bone_idx)
+ var looked_at: Transform3D = _y_look_at(rest, target_coordinate)
+ skeleton.set_bone_global_pose(bone_idx, Transform3D(looked_at.basis.orthonormalized(), skeleton.get_bone_global_pose(bone_idx).origin))
+
+func _y_look_at(from: Transform3D, target: Vector3) -> Transform3D:
+ var t_v: Vector3 = target - from.origin
+ var v_y: Vector3 = t_v.normalized()
+ var v_z: Vector3 = from.basis.x.cross(v_y)
+ v_z = v_z.normalized()
+ var v_x: Vector3 = v_y.cross(v_z)
+ from.basis = Basis(v_x, v_y, v_z)
+ return from
+```
+
+The `_process_modification()` is a virtual method called in the update process after the AnimationMixer has been applied, as described in the sequence diagram above. If you modify bones in it, it is guaranteed that the order in which the modifications are applied will match the order of `SkeletonModifier3D` of the `Skeleton3D`'s child list.
+
+
+
+Note that the modification should always be applied to the bones at 100% amount. Because `SkeletonModifier3D` has an influence property, the value of which is processed and interpolated by `Skeleton3D`. In other words, you do not need to write code to change the amount of modification applied. However, if your custom `SkeletonModifier3D` can specify multiple bones and you want to manage the amount separately for each bone, it makes sense that adding the properites for that.
+
+Finally, remember that this method will not be called if the parent is not a `Skeleton3D`.
+
+## 4. Retrieve modified values from other Nodes
+
+The modification by `SkeletonModifier3D` is immediately discarded after it is applied to the skin, so it is not reflected in the bone pose of `Skeleton3D` during `_process()`.
+
+If you need to retrieve the modificated pose values from other nodes, you must connect them to the appropriate signals.
+
+For example, this is a `Label3D` which reflects the modification after the animation is applied and after all modifications are processed.
+
+```gdscript
+@tool
+
+extends Label3D
+
+@onready var poses: Dictionary = { "animated_pose": "", "modified_pose": "" }
+
+func _update_text() -> void:
+ text = "animated_pose:" + str(poses["animated_pose"]) + "\n" + "modified_pose:" + str(poses["modified_pose"])
+
+func _on_animation_player_mixer_applied() -> void:
+ poses["animated_pose"] = $"../Armature/Skeleton3D".get_bone_pose(1)
+ _update_text()
+
+func _on_skeleton_3d_skeleton_updated() -> void:
+ poses["modified_pose"] = $"../Armature/Skeleton3D".get_bone_pose(1)
+ _update_text()
+```
+
+You can see the pose is different depending on the signal.
+
+
+
+### Download
+
+[skeleton-modifier-3d-demo-project.zip](/storage/blog/design-of-the-skeleton-modifier-3d/modified_poseskeleton-modifier-3d-demo-project.zip)
+
+# Do I always need to create a custom SkeletonModifier3D when modifying a Skeleton3D bone?
+
+As explained above, the modification provided by `SkeletonModifier3D` is temporary. So `SkeletonModifier3D` would be appropriate for effectors and controllers as **post FX**.
+
+If you want permanent modifications, i.e., if you want to develop something like a bone editor, then it makes sense that it is not a `SkeletonModifier3D`. Also, in simple cases where it is guaranteed that no other `SkeletonModifier3D` will be used in the scene, your judgment will prevail.
+
+# What kind of SkeletonModifier3D nodes are included in Godot 4.3?
+
+For now, Godot 4.3 will be containing only `SkeletonModifier3D` which is a migration of several existing nodes that have been in existence since 4.0.
+
+But, there is good news! We are planning to add some `SkeletonModifier3D` in Godot 4.4, such as new IK, constraint, and jiggle.
+
+If you are interested in developing your own `SkeletonModifier3D`, during 4.3 should be a great time to send a proposal to include it in core.
+
+## Support
+
+Godot is a non-profit, open source game engine developed by hundreds of contributors on their free time, as well as a handful of part or full-time developers hired thanks to [generous donations from the Godot community](https://fund.godotengine.org/). A big thank you to everyone who has contributed [their time](https://github.com/godotengine/godot/blob/master/AUTHORS.md) or [their financial support](https://github.com/godotengine/godot/blob/master/DONORS.md) to the project!
+
+If you'd like to support the project financially and help us secure our future hires, you can do so using the [Godot Development Fund](https://fund.godotengine.org/) platform managed by [Godot Foundation](https://godot.foundation/). There are also several [alternative ways to donate](/donate) which you may find more suitable.
diff --git a/storage/blog/covers/design-of-the-skeleton-modifier-3d.webp b/storage/blog/covers/design-of-the-skeleton-modifier-3d.webp
new file mode 100644
index 0000000000000000000000000000000000000000..479f7b618eafefd3dec5505dc74f87c161149b76
GIT binary patch
literal 874124
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