diff options
Diffstat (limited to 'doc/classes/ConeTwistJoint3D.xml')
-rw-r--r-- | doc/classes/ConeTwistJoint3D.xml | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/doc/classes/ConeTwistJoint3D.xml b/doc/classes/ConeTwistJoint3D.xml new file mode 100644 index 0000000000..e86e95bec3 --- /dev/null +++ b/doc/classes/ConeTwistJoint3D.xml @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<class name="ConeTwistJoint3D" inherits="Joint3D" version="4.0"> + <brief_description> + A twist joint between two 3D bodies. + </brief_description> + <description> + 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]. + 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. + </description> + <tutorials> + </tutorials> + <methods> + <method name="get_param" qualifiers="const"> + <return type="float"> + </return> + <argument index="0" name="param" type="int" enum="ConeTwistJoint3D.Param"> + </argument> + <description> + </description> + </method> + <method name="set_param"> + <return type="void"> + </return> + <argument index="0" name="param" type="int" enum="ConeTwistJoint3D.Param"> + </argument> + <argument index="1" name="value" type="float"> + </argument> + <description> + </description> + </method> + </methods> + <members> + <member name="bias" type="float" setter="set_param" getter="get_param" default="0.3"> + The speed with which the swing or twist will take place. + The higher, the faster. + </member> + <member name="relaxation" type="float" setter="set_param" getter="get_param" default="1.0"> + Defines, how fast the swing- and twist-speed-difference on both sides gets synced. + </member> + <member name="softness" type="float" setter="set_param" getter="get_param" default="0.8"> + The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint. + </member> + <member name="swing_span" type="float" setter="_set_swing_span" getter="_get_swing_span" default="45.0"> + Swing is rotation from side to side, around the axis perpendicular to the twist axis. + The swing span defines, how much rotation will not get corrected along the swing axis. + Could be defined as looseness in the [ConeTwistJoint3D]. + If below 0.05, this behavior is locked. + </member> + <member name="twist_span" type="float" setter="_set_twist_span" getter="_get_twist_span" default="180.0"> + Twist is the rotation around the twist axis, this value defined how far the joint can twist. + Twist is locked if below 0.05. + </member> + </members> + <constants> + <constant name="PARAM_SWING_SPAN" value="0" enum="Param"> + Swing is rotation from side to side, around the axis perpendicular to the twist axis. + The swing span defines, how much rotation will not get corrected along the swing axis. + Could be defined as looseness in the [ConeTwistJoint3D]. + If below 0.05, this behavior is locked. + </constant> + <constant name="PARAM_TWIST_SPAN" value="1" enum="Param"> + Twist is the rotation around the twist axis, this value defined how far the joint can twist. + Twist is locked if below 0.05. + </constant> + <constant name="PARAM_BIAS" value="2" enum="Param"> + The speed with which the swing or twist will take place. + The higher, the faster. + </constant> + <constant name="PARAM_SOFTNESS" value="3" enum="Param"> + The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint. + </constant> + <constant name="PARAM_RELAXATION" value="4" enum="Param"> + Defines, how fast the swing- and twist-speed-difference on both sides gets synced. + </constant> + <constant name="PARAM_MAX" value="5" enum="Param"> + Represents the size of the [enum Param] enum. + </constant> + </constants> +</class> |