2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-03-01 00:44:37 +00:00
<class name= "ConeTwistJoint3D" inherits= "Joint3D" version= "4.1" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-12 20:42:36 +00:00
<brief_description >
2020-12-24 00:46:56 +00:00
A twist joint between two 3D PhysicsBodies.
2017-09-12 20:42:36 +00:00
</brief_description>
<description >
2020-03-30 16:22:57 +00:00
The joint can rotate the bodies across an axis defined by the local x-axes of the [Joint3D].
The twist axis is initiated as the X axis of the [Joint3D].
2020-12-24 00:46:56 +00:00
Once the Bodies swing, the twist axis is calculated as the middle of the x-axes of the Joint3D in the local space of the two Bodies. See also [Generic6DOFJoint3D].
2017-09-12 20:42:36 +00:00
</description>
<tutorials >
</tutorials>
<methods >
2019-06-27 14:10:09 +00:00
<method name= "get_param" qualifiers= "const" >
2021-07-30 13:28:05 +00:00
<return type= "float" />
2022-08-06 18:11:48 +00:00
<param index= "0" name= "param" type= "int" enum= "ConeTwistJoint3D.Param" />
2019-06-27 14:10:09 +00:00
<description >
2023-02-28 14:06:21 +00:00
Returns the value of the specified parameter.
2019-06-27 14:10:09 +00:00
</description>
</method>
<method name= "set_param" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
2022-08-06 18:11:48 +00:00
<param index= "0" name= "param" type= "int" enum= "ConeTwistJoint3D.Param" />
<param index= "1" name= "value" type= "float" />
2019-06-27 14:10:09 +00:00
<description >
2023-02-28 14:06:21 +00:00
Sets the value of the specified parameter.
2019-06-27 14:10:09 +00:00
</description>
</method>
2017-09-12 20:42:36 +00:00
</methods>
<members >
2019-06-29 10:38:01 +00:00
<member name= "bias" type= "float" setter= "set_param" getter= "get_param" default= "0.3" >
2017-10-14 10:19:03 +00:00
The speed with which the swing or twist will take place.
The higher, the faster.
2017-09-12 20:42:36 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "relaxation" type= "float" setter= "set_param" getter= "get_param" default= "1.0" >
2017-10-14 10:19:03 +00:00
Defines, how fast the swing- and twist-speed-difference on both sides gets synced.
2017-09-12 20:42:36 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "softness" type= "float" setter= "set_param" getter= "get_param" default= "0.8" >
2017-10-14 10:19:03 +00:00
The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint.
2017-09-12 20:42:36 +00:00
</member>
2022-08-22 09:30:48 +00:00
<member name= "swing_span" type= "float" setter= "set_param" getter= "get_param" default= "0.785398" >
2017-10-14 10:19:03 +00:00
Swing is rotation from side to side, around the axis perpendicular to the twist axis.
2019-06-27 09:10:53 +00:00
The swing span defines, how much rotation will not get corrected along the swing axis.
2020-03-30 16:22:57 +00:00
Could be defined as looseness in the [ConeTwistJoint3D].
2019-06-29 13:24:23 +00:00
If below 0.05, this behavior is locked.
2017-09-12 20:42:36 +00:00
</member>
2022-08-22 09:30:48 +00:00
<member name= "twist_span" type= "float" setter= "set_param" getter= "get_param" default= "3.14159" >
2017-10-14 10:19:03 +00:00
Twist is the rotation around the twist axis, this value defined how far the joint can twist.
Twist is locked if below 0.05.
2017-09-12 20:42:36 +00:00
</member>
</members>
<constants >
2017-11-24 22:16:30 +00:00
<constant name= "PARAM_SWING_SPAN" value= "0" enum= "Param" >
2017-10-14 10:19:03 +00:00
Swing is rotation from side to side, around the axis perpendicular to the twist axis.
2019-06-27 09:10:53 +00:00
The swing span defines, how much rotation will not get corrected along the swing axis.
2020-03-30 16:22:57 +00:00
Could be defined as looseness in the [ConeTwistJoint3D].
2019-06-29 13:24:23 +00:00
If below 0.05, this behavior is locked.
2017-09-12 20:42:36 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name= "PARAM_TWIST_SPAN" value= "1" enum= "Param" >
2017-10-14 10:19:03 +00:00
Twist is the rotation around the twist axis, this value defined how far the joint can twist.
Twist is locked if below 0.05.
2017-09-12 20:42:36 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name= "PARAM_BIAS" value= "2" enum= "Param" >
2017-10-14 10:19:03 +00:00
The speed with which the swing or twist will take place.
The higher, the faster.
2017-09-12 20:42:36 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name= "PARAM_SOFTNESS" value= "3" enum= "Param" >
2017-10-14 10:19:03 +00:00
The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint.
2017-09-12 20:42:36 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name= "PARAM_RELAXATION" value= "4" enum= "Param" >
2017-10-14 10:19:03 +00:00
Defines, how fast the swing- and twist-speed-difference on both sides gets synced.
2017-09-12 20:42:36 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name= "PARAM_MAX" value= "5" enum= "Param" >
2019-06-27 09:10:53 +00:00
Represents the size of the [enum Param] enum.
2017-09-12 20:42:36 +00:00
</constant>
</constants>
</class>