OverviewFilesCommitsIssuesDocsReleasesPeers

nvidia-rtx-godot / doc / classes / BoneConstraint3D.xml

154 lines · xml ref:
<?xml version="1.0" encoding="UTF-8" ?>
<class name="BoneConstraint3D" inherits="SkeletonModifier3D" api_type="core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		A node that may modify Skeleton3D's bone with associating the two bones.
	</brief_description>
	<description>
		Base class of [SkeletonModifier3D] that modifies the bone set in [method set_apply_bone] based on the transform of the bone retrieved by [method get_reference_bone].
		[b]Note:[/b] Most methods in this class take an [code]index[/code] parameter. This parameter specifies which setting list entry to return if the IK has multiple entries (e.g. [code]settings/&lt;index&gt;/amount[/code]).
	</description>
	<tutorials>
	</tutorials>
	<methods>
		<method name="clear_setting">
			<return type="void" />
			<description>
				Clear all settings.
			</description>
		</method>
		<method name="get_amount" qualifiers="const">
			<return type="float" />
			<param index="0" name="index" type="int" />
			<description>
				Returns the apply amount of the setting at [param index].
			</description>
		</method>
		<method name="get_apply_bone" qualifiers="const">
			<return type="int" />
			<param index="0" name="index" type="int" />
			<description>
				Returns the apply bone of the setting at [param index]. This bone will be modified.
			</description>
		</method>
		<method name="get_apply_bone_name" qualifiers="const">
			<return type="String" />
			<param index="0" name="index" type="int" />
			<description>
				Returns the apply bone name of the setting at [param index]. This bone will be modified.
			</description>
		</method>
		<method name="get_reference_bone" qualifiers="const">
			<return type="int" />
			<param index="0" name="index" type="int" />
			<description>
				Returns the reference bone of the setting at [param index].
				This bone will be only referenced and not modified by this modifier.
			</description>
		</method>
		<method name="get_reference_bone_name" qualifiers="const">
			<return type="String" />
			<param index="0" name="index" type="int" />
			<description>
				Returns the reference bone name of the setting at [param index].
				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>
				Returns the number of settings in the modifier.
			</description>
		</method>
		<method name="set_amount">
			<return type="void" />
			<param index="0" name="index" type="int" />
			<param index="1" name="amount" type="float" />
			<description>
				Sets the apply amount of the setting at [param index] to [param amount].
			</description>
		</method>
		<method name="set_apply_bone">
			<return type="void" />
			<param index="0" name="index" type="int" />
			<param index="1" name="bone" type="int" />
			<description>
				Sets the apply bone of the setting at [param index] to [param bone]. This bone will be modified.
			</description>
		</method>
		<method name="set_apply_bone_name">
			<return type="void" />
			<param index="0" name="index" type="int" />
			<param index="1" name="bone_name" type="String" />
			<description>
				Sets the apply bone of the setting at [param index] to [param bone_name]. This bone will be modified.
			</description>
		</method>
		<method name="set_reference_bone">
			<return type="void" />
			<param index="0" name="index" type="int" />
			<param index="1" name="bone" type="int" />
			<description>
				Sets the reference bone of the setting at [param index] to [param bone].
				This bone will be only referenced and not modified by this modifier.
			</description>
		</method>
		<method name="set_reference_bone_name">
			<return type="void" />
			<param index="0" name="index" type="int" />
			<param index="1" name="bone_name" type="String" />
			<description>
				Sets the reference bone of the setting at [param index] to [param bone_name].
				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" />
			<description>
				Sets the number of settings in the modifier.
			</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>