mirror of
https://github.com/Relintai/pandemonium_engine.git
synced 2024-12-20 19:06:53 +01:00
Relintai
521934ff55
This PR and commit adds a new IK system for 2D with the Skeleton2D node
that adds several new IK solvers, a way to control bones in a Skeleton2D
node similar to that in Skeleton3D. It also adds additional changes
and functionality.
This work was sponsored by GSoC 2020 and TwistedTwigleg.
Full list of changes:
* Adds a SkeletonModifier2D resource
* This resource is the base where all IK code is written and executed
* Has a function for clamping angles, since it is so commonly used
* Modifiers are unique when duplicated so it works with instancing
* Adds a SkeletonModifierStack2D resource
* This resource manages a series of SkeletonModification2Ds
* This is what the Skeleton2D directly interfaces with to make IK possible
* Adds SkeletonModifier2D resources for LookAt, CCDIK, FABRIK, Jiggle, and TwoBoneIK
* Each modification is in its own file
* There is also a SkeletonModifier2D resource that acts as a stack for using multiple stacks together
* Adds a PhysicalBone2D node
* Works similar to the PhysicalBone3D node, but uses a RigidBody2D node
* Changes to Skeleton2D listed below:
* Skeleton2D now holds a single SkeletonModificationStack2D for IK
* Skeleton2D now has a local_pose_override, which overrides the Bone2D position similar to how the overrides work in Skeleton3D
* Changes to Bone2D listed below:
* The default_length property has been changed to length. Length is the length of the bone to its child bone node
* New bone_angle property, which is the angle the bone has to its first child bone node
* Bone2D caches its transform when not modified by IK for IK interpolation purposes
* Bone2D draws its own editor gizmo, though this is stated to change in the future
* Changes to CanvasItemEditor listed below:
* Bone2D gizmo drawing code removed
* The 2D IK code is removed. Now Bone2D is the only bone system for 2D
* Transform2D now has a looking_at function for rotating to face a position
* Two new node notifications: NOTIFICATION_EDITOR_PRE_SAVE and NOTIFICATION_EDITOR_POST_SAVE
* These notifications only are called in the editor right before and after saving a scene
* Needed for not saving the IK position when executing IK in the editor
* Documentation for all the changes listed above.
- TwistedTwigleg
8aa3c2f091
96 lines
3.5 KiB
XML
96 lines
3.5 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="Skeleton2D" inherits="Node2D" version="3.5">
|
|
<brief_description>
|
|
Skeleton for 2D characters and animated objects.
|
|
</brief_description>
|
|
<description>
|
|
Skeleton2D parents a hierarchy of [Bone2D] objects. It is a requirement of [Bone2D]. Skeleton2D holds a reference to the rest pose of its children and acts as a single point of access to its bones.
|
|
</description>
|
|
<tutorials>
|
|
<link>$DOCS_URL/tutorials/animation/2d_skeletons.html</link>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="execute_modifications">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="delta" type="float">
|
|
</argument>
|
|
<argument index="1" name="execution_mode" type="int">
|
|
</argument>
|
|
<description>
|
|
Executes all the modifications on the [SkeletonModificationStack2D], if the Skeleton3D has one assigned.
|
|
</description>
|
|
</method>
|
|
<method name="get_bone">
|
|
<return type="Bone2D" />
|
|
<argument index="0" name="idx" type="int" />
|
|
<description>
|
|
Returns a [Bone2D] from the node hierarchy parented by Skeleton2D. The object to return is identified by the parameter [code]idx[/code]. Bones are indexed by descending the node hierarchy from top to bottom, adding the children of each branch before moving to the next sibling.
|
|
</description>
|
|
</method>
|
|
<method name="get_bone_count" qualifiers="const">
|
|
<return type="int" />
|
|
<description>
|
|
Returns the number of [Bone2D] nodes in the node hierarchy parented by Skeleton2D.
|
|
</description>
|
|
</method>
|
|
<method name="get_bone_local_pose_override">
|
|
<return type="Transform2D">
|
|
</return>
|
|
<argument index="0" name="bone_idx" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the local pose override transform for [code]bone_idx[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_modification_stack" qualifiers="const">
|
|
<return type="SkeletonModificationStack2D">
|
|
</return>
|
|
<description>
|
|
Returns the [SkeletonModificationStack2D] attached to this skeleton, if one exists.
|
|
</description>
|
|
</method>
|
|
<method name="get_skeleton" qualifiers="const">
|
|
<return type="RID" />
|
|
<description>
|
|
Returns the [RID] of a Skeleton2D instance.
|
|
</description>
|
|
</method>
|
|
<method name="set_bone_local_pose_override">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="bone_idx" type="int">
|
|
</argument>
|
|
<argument index="1" name="override_pose" type="Transform2D">
|
|
</argument>
|
|
<argument index="2" name="strength" type="float">
|
|
</argument>
|
|
<argument index="3" name="persistent" type="bool">
|
|
</argument>
|
|
<description>
|
|
Sets the local pose transform, [code]pose[/code], for the bone at [code]bone_idx[/code].
|
|
[code]amount[/code] is the interpolation strengh that will be used when applying the pose, and [code]persistent[/code] determines if the applied pose will remain.
|
|
[b]Note:[/b] The pose transform needs to be a local transform relative to the [Bone2D] node at [code]bone_idx[/code]!
|
|
</description>
|
|
</method>
|
|
<method name="set_modification_stack">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="modification_stack" type="SkeletonModificationStack2D">
|
|
</argument>
|
|
<description>
|
|
Sets the [SkeletonModificationStack2D] attached to this skeleton.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<signals>
|
|
<signal name="bone_setup_changed">
|
|
<description>
|
|
Emitted when the [Bone2D] setup attached to this skeletons changes. This is primarily used internally within the skeleton.
|
|
</description>
|
|
</signal>
|
|
</signals>
|
|
<constants>
|
|
</constants>
|
|
</class>
|