seedlingattempt/godot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #110336 from TokageItLab/constraint-mod-node

Browse Source 
Add option to `BoneConstraint3D` to make reference target allow to set `Node3D`
This commit is contained in:
Thaddeus Crews
2025-11-14 17:16:43 -06:00
parent aa248bfedd a57f96110a
commit 76e974da7c
11 changed files with 383 additions and 140 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
doc/classes/BoneConstraint3D.xml
View File

@ -52,6 +52,21 @@
This bone will be only referenced and not modified by this modifier.
</description>
</method>
<method name="get_reference_node" qualifiers="const">
<return type="NodePath" />
<param index="0" name="index" type="int" />
<description>
Returns the reference node path of the setting at [param index].
This node will be only referenced and not modified by this modifier.
</description>
</method>
<method name="get_reference_type" qualifiers="const">
<return type="int" enum="BoneConstraint3D.ReferenceType" />
<param index="0" name="index" type="int" />
<description>
Returns the reference target type of the setting at [param index]. See also [enum ReferenceType].
</description>
</method>
<method name="get_setting_count" qualifiers="const">
<return type="int" />
<description>
@ -100,6 +115,23 @@
This bone will be only referenced and not modified by this modifier.
</description>
</method>
<method name="set_reference_node">
<return type="void" />
<param index="0" name="index" type="int" />
<param index="1" name="node" type="NodePath" />
<description>
Sets the reference node path of the setting at [param index] to [param node].
This node will be only referenced and not modified by this modifier.
</description>
</method>
<method name="set_reference_type">
<return type="void" />
<param index="0" name="index" type="int" />
<param index="1" name="type" type="int" enum="BoneConstraint3D.ReferenceType" />
<description>
Sets the reference target type of the setting at [param index] to [param type]. See also [enum ReferenceType].
</description>
</method>
<method name="set_setting_count">
<return type="void" />
<param index="0" name="count" type="int" />
@ -108,4 +140,13 @@
</description>
</method>
</methods>
<constants>
<constant name="REFERENCE_TYPE_BONE" value="0" enum="ReferenceType">
The reference target is a bone. In this case, the reference target spaces is local space.
</constant>
<constant name="REFERENCE_TYPE_NODE" value="1" enum="ReferenceType">
The reference target is a [Node3D]. In this case, the reference target spaces is model space.
In other words, the reference target's coordinates are treated as if it were placed directly under [Skeleton3D] which parent of the [BoneConstraint3D].
</constant>
</constants>
</class>

1
doc/classes/ConvertTransformModifier3D.xml
View File

@ -14,6 +14,7 @@
- Extract reference pose absolutely and add it to the apply bone's pose.
[b]Not Relative + Not Additive:[/b]
- Extract reference pose absolutely and the apply bone's pose is replaced with it.
[b]Note:[/b] Relative option is available only in the case [method BoneConstraint3D.get_reference_type] is [constant BoneConstraint3D.REFERENCE_TYPE_BONE]. See also [enum BoneConstraint3D.ReferenceType].
</description>
<tutorials>
</tutorials>

1
doc/classes/CopyTransformModifier3D.xml
View File

@ -14,6 +14,7 @@
- Extract reference pose absolutely and add it to the apply bone's pose.
[b]Not Relative + Not Additive:[/b]
- Extract reference pose absolutely and the apply bone's pose is replaced with it.
[b]Note:[/b] Relative option is available only in the case [method BoneConstraint3D.get_reference_type] is [constant BoneConstraint3D.REFERENCE_TYPE_BONE]. See also [enum BoneConstraint3D.ReferenceType].
</description>
<tutorials>
</tutorials>