2017-09-13 04:42:36 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2020-03-31 00:22:57 +08:00
<class name= "ConeTwistJoint3D" inherits= "Joint3D" version= "4.0" >
2017-09-13 04:42:36 +08:00
<brief_description >
2020-12-24 08:46:56 +08:00
A twist joint between two 3D PhysicsBodies.
2017-09-13 04:42:36 +08:00
</brief_description>
<description >
2020-03-31 00:22:57 +08: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 08:46:56 +08: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-13 04:42:36 +08:00
</description>
<tutorials >
</tutorials>
<methods >
2019-06-27 22:10:09 +08:00
<method name= "get_param" qualifiers= "const" >
<return type= "float" >
</return>
2020-03-31 00:22:57 +08:00
<argument index= "0" name= "param" type= "int" enum= "ConeTwistJoint3D.Param" >
2019-06-27 22:10:09 +08:00
</argument>
<description >
</description>
</method>
<method name= "set_param" >
<return type= "void" >
</return>
2020-03-31 00:22:57 +08:00
<argument index= "0" name= "param" type= "int" enum= "ConeTwistJoint3D.Param" >
2019-06-27 22:10:09 +08:00
</argument>
<argument index= "1" name= "value" type= "float" >
</argument>
<description >
</description>
</method>
2017-09-13 04:42:36 +08:00
</methods>
<members >
2019-06-29 18:38:01 +08:00
<member name= "bias" type= "float" setter= "set_param" getter= "get_param" default= "0.3" >
2017-10-14 18:19:03 +08:00
The speed with which the swing or twist will take place.
The higher, the faster.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "relaxation" type= "float" setter= "set_param" getter= "get_param" default= "1.0" >
2017-10-14 18:19:03 +08:00
Defines, how fast the swing- and twist-speed-difference on both sides gets synced.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "softness" type= "float" setter= "set_param" getter= "get_param" default= "0.8" >
2017-10-14 18:19:03 +08: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-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "swing_span" type= "float" setter= "_set_swing_span" getter= "_get_swing_span" default= "45.0" >
2017-10-14 18:19:03 +08:00
Swing is rotation from side to side, around the axis perpendicular to the twist axis.
2019-06-27 17:10:53 +08:00
The swing span defines, how much rotation will not get corrected along the swing axis.
2020-03-31 00:22:57 +08:00
Could be defined as looseness in the [ConeTwistJoint3D].
2019-06-29 21:24:23 +08:00
If below 0.05, this behavior is locked.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "twist_span" type= "float" setter= "_set_twist_span" getter= "_get_twist_span" default= "180.0" >
2017-10-14 18:19:03 +08: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-13 04:42:36 +08:00
</member>
</members>
<constants >
2017-11-25 06:16:30 +08:00
<constant name= "PARAM_SWING_SPAN" value= "0" enum= "Param" >
2017-10-14 18:19:03 +08:00
Swing is rotation from side to side, around the axis perpendicular to the twist axis.
2019-06-27 17:10:53 +08:00
The swing span defines, how much rotation will not get corrected along the swing axis.
2020-03-31 00:22:57 +08:00
Could be defined as looseness in the [ConeTwistJoint3D].
2019-06-29 21:24:23 +08:00
If below 0.05, this behavior is locked.
2017-09-13 04:42:36 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "PARAM_TWIST_SPAN" value= "1" enum= "Param" >
2017-10-14 18:19:03 +08: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-13 04:42:36 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "PARAM_BIAS" value= "2" enum= "Param" >
2017-10-14 18:19:03 +08:00
The speed with which the swing or twist will take place.
The higher, the faster.
2017-09-13 04:42:36 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "PARAM_SOFTNESS" value= "3" enum= "Param" >
2017-10-14 18:19:03 +08: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-13 04:42:36 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "PARAM_RELAXATION" value= "4" enum= "Param" >
2017-10-14 18:19:03 +08:00
Defines, how fast the swing- and twist-speed-difference on both sides gets synced.
2017-09-13 04:42:36 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "PARAM_MAX" value= "5" enum= "Param" >
2019-06-27 17:10:53 +08:00
Represents the size of the [enum Param] enum.
2017-09-13 04:42:36 +08:00
</constant>
</constants>
</class>