192 lines
9.3 KiB
XML
192 lines
9.3 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="SkeletonModification3DTwoBoneIK" inherits="SkeletonModification3D" version="4.0">
|
|
<brief_description>
|
|
A modification that moves two bones to reach the target.
|
|
</brief_description>
|
|
<description>
|
|
This [SkeletonModification3D] uses an algorithm typically called TwoBoneIK. This algorithm works by leveraging the law of cosigns and the lengths of the bones to figure out what rotation the bones currently have, and what rotation they need to make a complete triangle, where the first bone, the second bone, and the target form the three vertices of the triangle. Because the algorithm works by making a triangle, it can only operate on two bones.
|
|
TwoBoneIK is great for arms, legs, and really any joints that can be represented by just two bones that bend to reach a target. This solver is more lightweight than [SkeletonModification3DFABRIK], but gives similar, natural looking results.
|
|
A [Node3D]-based node can be used to define the pole, or bend direction, allowing control over which direction the joint takes when bending to reach the target when the target is within reach.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="get_auto_calculate_joint_length" qualifiers="const">
|
|
<return type="bool" />
|
|
<description>
|
|
Returns whether the TwoBoneIK modification will attempt to autocalculate the lengths of the two bones.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_one_bone_idx" qualifiers="const">
|
|
<return type="int" />
|
|
<description>
|
|
Returns the bone index of the first bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_one_bone_name" qualifiers="const">
|
|
<return type="String" />
|
|
<description>
|
|
Returns the name of the first bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_one_length" qualifiers="const">
|
|
<return type="float" />
|
|
<description>
|
|
Returns the length of the first bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_one_roll" qualifiers="const">
|
|
<return type="float" />
|
|
<description>
|
|
Returns the amount of roll/twist applied to the first bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_two_bone_idx" qualifiers="const">
|
|
<return type="int" />
|
|
<description>
|
|
Returns the bone index of the second bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_two_bone_name" qualifiers="const">
|
|
<return type="String" />
|
|
<description>
|
|
Returns the name of the second bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_two_length" qualifiers="const">
|
|
<return type="float" />
|
|
<description>
|
|
Returns the length of the second bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_joint_two_roll" qualifiers="const">
|
|
<return type="float" />
|
|
<description>
|
|
Returns the amount of roll/twist applied to the second bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="get_pole_node" qualifiers="const">
|
|
<return type="NodePath" />
|
|
<description>
|
|
Returns the node that is being used as the pole node for the TwoBoneIK modification, if a pole node has been set.
|
|
</description>
|
|
</method>
|
|
<method name="get_tip_node" qualifiers="const">
|
|
<return type="NodePath" />
|
|
<description>
|
|
Returns the node that is being used to calculate the tip position of the second bone in the TwoBoneIK modification, if a tip node has been set.
|
|
</description>
|
|
</method>
|
|
<method name="get_use_pole_node" qualifiers="const">
|
|
<return type="bool" />
|
|
<description>
|
|
Returns whether the TwoBoneIK modification will attempt to use the pole node to figure out which direction to bend, if a pole node has been set.
|
|
</description>
|
|
</method>
|
|
<method name="get_use_tip_node" qualifiers="const">
|
|
<return type="bool" />
|
|
<description>
|
|
Returns whether the TwoBoneIK modification will attempt to use the tip node to figure out the length and position of the tip of the second bone.
|
|
</description>
|
|
</method>
|
|
<method name="set_auto_calculate_joint_length">
|
|
<return type="void" />
|
|
<argument index="0" name="auto_calculate_joint_length" type="bool" />
|
|
<description>
|
|
If true, the TwoBoneIK modification will attempt to autocalculate the lengths of the bones being used. The first bone will be calculated by using the distance from the origin of the first bone to the origin of the second bone.
|
|
The second bone will be calculated either using the tip node if that setting is enabled, or by using the distances of the second bone's children. If the tip node is not enabled and the bone has no children, then the length cannot be autocalculated. In this case, the length will either have to be manually inputted or a tip node used to calculate the length.
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_one_bone_idx">
|
|
<return type="void" />
|
|
<argument index="0" name="bone_idx" type="int" />
|
|
<description>
|
|
Sets the bone index, [code]bone_index[/code], of the first bone. When possible, this will also update the [code]bone_name[/code] of the first bone based on data provided by the [Skeleton3D].
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_one_bone_name">
|
|
<return type="void" />
|
|
<argument index="0" name="bone_name" type="String" />
|
|
<description>
|
|
Sets the bone name, [code]bone_name[/code], of the first bone. When possible, this will also update the [code]bone_index[/code] of the first bone based on data provided by the [Skeleton3D].
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_one_length">
|
|
<return type="void" />
|
|
<argument index="0" name="bone_length" type="float" />
|
|
<description>
|
|
Sets the length of the first bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_one_roll">
|
|
<return type="void" />
|
|
<argument index="0" name="roll" type="float" />
|
|
<description>
|
|
Sets the amount of roll/twist applied to the first bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_two_bone_idx">
|
|
<return type="void" />
|
|
<argument index="0" name="bone_idx" type="int" />
|
|
<description>
|
|
Sets the bone index, [code]bone_index[/code], of the second bone. When possible, this will also update the [code]bone_name[/code] of the second bone based on data provided by the [Skeleton3D].
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_two_bone_name">
|
|
<return type="void" />
|
|
<argument index="0" name="bone_name" type="String" />
|
|
<description>
|
|
Sets the bone name, [code]bone_name[/code], of the second bone. When possible, this will also update the [code]bone_index[/code] of the second bone based on data provided by the [Skeleton3D].
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_two_length">
|
|
<return type="void" />
|
|
<argument index="0" name="bone_length" type="float" />
|
|
<description>
|
|
Sets the length of the second bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="set_joint_two_roll">
|
|
<return type="void" />
|
|
<argument index="0" name="roll" type="float" />
|
|
<description>
|
|
Sets the amount of roll/twist applied to the second bone in the TwoBoneIK modification.
|
|
</description>
|
|
</method>
|
|
<method name="set_pole_node">
|
|
<return type="void" />
|
|
<argument index="0" name="pole_nodepath" type="NodePath" />
|
|
<description>
|
|
Sets the node to be used as the for the pole of the TwoBoneIK. When a node is set and the modification is set to use the pole node, the TwoBoneIK modification will bend the nodes in the direction towards this node when the bones need to bend.
|
|
</description>
|
|
</method>
|
|
<method name="set_tip_node">
|
|
<return type="void" />
|
|
<argument index="0" name="tip_nodepath" type="NodePath" />
|
|
<description>
|
|
Sets the node to be used as the tip for the second bone. This is used to calculate the length and position of the end of the second bone in the TwoBoneIK modification.
|
|
[b]Note:[/b] The tip node should generally be a child node of a [BoneAttachment3D] node attached to the second bone, with the child node being offset so it is at the end of the bone.
|
|
</description>
|
|
</method>
|
|
<method name="set_use_pole_node">
|
|
<return type="void" />
|
|
<argument index="0" name="use_pole_node" type="bool" />
|
|
<description>
|
|
When [code]true[/code], the TwoBoneIK modification will bend the bones towards the pole node, if one has been set. This gives control over the direction the TwoBoneIK solver will bend, which is helpful for joints like elbows that only bend in certain directions.
|
|
</description>
|
|
</method>
|
|
<method name="set_use_tip_node">
|
|
<return type="void" />
|
|
<argument index="0" name="use_tip_node" type="bool" />
|
|
<description>
|
|
When [code]true[/code], the TwoBoneIK modification will use the tip node to calculate the distance and position of the end/tip of the second bone. This is the most stable solution for knowing the tip position and length of the second bone.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="target_nodepath" type="NodePath" setter="set_target_node" getter="get_target_node" default="NodePath("")">
|
|
The NodePath to the node that is the target for the TwoBoneIK modification. This node is what the modification will attempt to rotate the bones to reach.
|
|
</member>
|
|
</members>
|
|
</class>
|