Browse Source

Merge pull request #97609 from Manik2607/master

Add missing descriptions to `PhysicalBone3D` class.
Thaddeus Crews 9 months ago
parent
commit
3ee0c0a76e
1 changed files with 15 additions and 0 deletions
  1. 15 0
      doc/classes/PhysicalBone3D.xml

+ 15 - 0
doc/classes/PhysicalBone3D.xml

@@ -21,6 +21,9 @@
 			<return type="void" />
 			<return type="void" />
 			<param index="0" name="impulse" type="Vector3" />
 			<param index="0" name="impulse" type="Vector3" />
 			<description>
 			<description>
+				Applies a directional impulse without affecting rotation.
+				An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_integrate_forces" functions otherwise).
+				This is equivalent to using [method apply_impulse] at the body's center of mass.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="apply_impulse">
 		<method name="apply_impulse">
@@ -28,21 +31,27 @@
 			<param index="0" name="impulse" type="Vector3" />
 			<param index="0" name="impulse" type="Vector3" />
 			<param index="1" name="position" type="Vector3" default="Vector3(0, 0, 0)" />
 			<param index="1" name="position" type="Vector3" default="Vector3(0, 0, 0)" />
 			<description>
 			<description>
+				Applies a positioned impulse to the PhysicsBone3D.
+				An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_integrate_forces" functions otherwise).
+				[param position] is the offset from the PhysicsBone3D origin in global coordinates.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_bone_id" qualifiers="const">
 		<method name="get_bone_id" qualifiers="const">
 			<return type="int" />
 			<return type="int" />
 			<description>
 			<description>
+				Returns the unique identifier of the PhysicsBone3D.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_simulate_physics">
 		<method name="get_simulate_physics">
 			<return type="bool" />
 			<return type="bool" />
 			<description>
 			<description>
+				Returns [code]true[/code] if the PhysicsBone3D is allowed to simulate physics.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="is_simulating_physics">
 		<method name="is_simulating_physics">
 			<return type="bool" />
 			<return type="bool" />
 			<description>
 			<description>
+				Returns [code]true[/code] if the PhysicsBone3D is currently simulating physics.
 			</description>
 			</description>
 		</method>
 		</method>
 	</methods>
 	</methods>
@@ -108,16 +117,22 @@
 			In this mode, the body's damping value replaces any value set in areas or the default value.
 			In this mode, the body's damping value replaces any value set in areas or the default value.
 		</constant>
 		</constant>
 		<constant name="JOINT_TYPE_NONE" value="0" enum="JointType">
 		<constant name="JOINT_TYPE_NONE" value="0" enum="JointType">
+			No joint is applied to the PhysicsBone3D.
 		</constant>
 		</constant>
 		<constant name="JOINT_TYPE_PIN" value="1" enum="JointType">
 		<constant name="JOINT_TYPE_PIN" value="1" enum="JointType">
+			A pin joint is applied to the PhysicsBone3D.
 		</constant>
 		</constant>
 		<constant name="JOINT_TYPE_CONE" value="2" enum="JointType">
 		<constant name="JOINT_TYPE_CONE" value="2" enum="JointType">
+			A cone joint is applied to the PhysicsBone3D.
 		</constant>
 		</constant>
 		<constant name="JOINT_TYPE_HINGE" value="3" enum="JointType">
 		<constant name="JOINT_TYPE_HINGE" value="3" enum="JointType">
+			A hinge joint is applied to the PhysicsBone3D.
 		</constant>
 		</constant>
 		<constant name="JOINT_TYPE_SLIDER" value="4" enum="JointType">
 		<constant name="JOINT_TYPE_SLIDER" value="4" enum="JointType">
+			A slider joint is applied to the PhysicsBone3D.
 		</constant>
 		</constant>
 		<constant name="JOINT_TYPE_6DOF" value="5" enum="JointType">
 		<constant name="JOINT_TYPE_6DOF" value="5" enum="JointType">
+			A 6 degrees of freedom joint is applied to the PhysicsBone3D.
 		</constant>
 		</constant>
 	</constants>
 	</constants>
 </class>
 </class>