mirror of
https://github.com/Relintai/pandemonium_engine_docs.git
synced 2025-01-23 15:17:21 +01:00
190 lines
6.9 KiB
ReStructuredText
190 lines
6.9 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. DO NOT EDIT THIS FILE!!!
|
|
.. Generated automatically from Godot engine sources.
|
|
.. Generator: https://github.com/godotengine/godot/tree/3.5/doc/tools/make_rst.py.
|
|
.. XML source: https://github.com/godotengine/godot/tree/3.5/doc/classes/ConeTwistJoint.xml.
|
|
|
|
.. _class_ConeTwistJoint:
|
|
|
|
ConeTwistJoint
|
|
==============
|
|
|
|
**Inherits:** :ref:`Joint<class_Joint>` **<** :ref:`Spatial<class_Spatial>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
|
|
|
A twist joint between two 3D PhysicsBodies.
|
|
|
|
Description
|
|
-----------
|
|
|
|
The joint can rotate the bodies across an axis defined by the local x-axes of the :ref:`Joint<class_Joint>`.
|
|
|
|
The twist axis is initiated as the X axis of the :ref:`Joint<class_Joint>`.
|
|
|
|
Once the Bodies swing, the twist axis is calculated as the middle of the x-axes of the Joint in the local space of the two Bodies. See also :ref:`Generic6DOFJoint<class_Generic6DOFJoint>`.
|
|
|
|
Properties
|
|
----------
|
|
|
|
+---------------------------+-------------------------------------------------------------+-----------+
|
|
| :ref:`float<class_float>` | :ref:`bias<class_ConeTwistJoint_property_bias>` | ``0.3`` |
|
|
+---------------------------+-------------------------------------------------------------+-----------+
|
|
| :ref:`float<class_float>` | :ref:`relaxation<class_ConeTwistJoint_property_relaxation>` | ``1.0`` |
|
|
+---------------------------+-------------------------------------------------------------+-----------+
|
|
| :ref:`float<class_float>` | :ref:`softness<class_ConeTwistJoint_property_softness>` | ``0.8`` |
|
|
+---------------------------+-------------------------------------------------------------+-----------+
|
|
| :ref:`float<class_float>` | :ref:`swing_span<class_ConeTwistJoint_property_swing_span>` | ``45.0`` |
|
|
+---------------------------+-------------------------------------------------------------+-----------+
|
|
| :ref:`float<class_float>` | :ref:`twist_span<class_ConeTwistJoint_property_twist_span>` | ``180.0`` |
|
|
+---------------------------+-------------------------------------------------------------+-----------+
|
|
|
|
Methods
|
|
-------
|
|
|
|
+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_param<class_ConeTwistJoint_method_get_param>` **(** :ref:`Param<enum_ConeTwistJoint_Param>` param **)** |const| |
|
|
+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_param<class_ConeTwistJoint_method_set_param>` **(** :ref:`Param<enum_ConeTwistJoint_Param>` param, :ref:`float<class_float>` value **)** |
|
|
+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
Enumerations
|
|
------------
|
|
|
|
.. _enum_ConeTwistJoint_Param:
|
|
|
|
.. _class_ConeTwistJoint_constant_PARAM_SWING_SPAN:
|
|
|
|
.. _class_ConeTwistJoint_constant_PARAM_TWIST_SPAN:
|
|
|
|
.. _class_ConeTwistJoint_constant_PARAM_BIAS:
|
|
|
|
.. _class_ConeTwistJoint_constant_PARAM_SOFTNESS:
|
|
|
|
.. _class_ConeTwistJoint_constant_PARAM_RELAXATION:
|
|
|
|
.. _class_ConeTwistJoint_constant_PARAM_MAX:
|
|
|
|
enum **Param**:
|
|
|
|
- **PARAM_SWING_SPAN** = **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 ``ConeTwistJoint``.
|
|
|
|
If below 0.05, this behavior is locked.
|
|
|
|
- **PARAM_TWIST_SPAN** = **1** --- Twist is the rotation around the twist axis, this value defined how far the joint can twist.
|
|
|
|
Twist is locked if below 0.05.
|
|
|
|
- **PARAM_BIAS** = **2** --- The speed with which the swing or twist will take place.
|
|
|
|
The higher, the faster.
|
|
|
|
- **PARAM_SOFTNESS** = **3** --- The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint.
|
|
|
|
- **PARAM_RELAXATION** = **4** --- Defines, how fast the swing- and twist-speed-difference on both sides gets synced.
|
|
|
|
- **PARAM_MAX** = **5** --- Represents the size of the :ref:`Param<enum_ConeTwistJoint_Param>` enum.
|
|
|
|
Property Descriptions
|
|
---------------------
|
|
|
|
.. _class_ConeTwistJoint_property_bias:
|
|
|
|
- :ref:`float<class_float>` **bias**
|
|
|
|
+-----------+------------------+
|
|
| *Default* | ``0.3`` |
|
|
+-----------+------------------+
|
|
| *Setter* | set_param(value) |
|
|
+-----------+------------------+
|
|
| *Getter* | get_param() |
|
|
+-----------+------------------+
|
|
|
|
The speed with which the swing or twist will take place.
|
|
|
|
The higher, the faster.
|
|
|
|
----
|
|
|
|
.. _class_ConeTwistJoint_property_relaxation:
|
|
|
|
- :ref:`float<class_float>` **relaxation**
|
|
|
|
+-----------+------------------+
|
|
| *Default* | ``1.0`` |
|
|
+-----------+------------------+
|
|
| *Setter* | set_param(value) |
|
|
+-----------+------------------+
|
|
| *Getter* | get_param() |
|
|
+-----------+------------------+
|
|
|
|
Defines, how fast the swing- and twist-speed-difference on both sides gets synced.
|
|
|
|
----
|
|
|
|
.. _class_ConeTwistJoint_property_softness:
|
|
|
|
- :ref:`float<class_float>` **softness**
|
|
|
|
+-----------+------------------+
|
|
| *Default* | ``0.8`` |
|
|
+-----------+------------------+
|
|
| *Setter* | set_param(value) |
|
|
+-----------+------------------+
|
|
| *Getter* | get_param() |
|
|
+-----------+------------------+
|
|
|
|
The ease with which the joint starts to twist. If it's too low, it takes more force to start twisting the joint.
|
|
|
|
----
|
|
|
|
.. _class_ConeTwistJoint_property_swing_span:
|
|
|
|
- :ref:`float<class_float>` **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 ``ConeTwistJoint``.
|
|
|
|
If below 0.05, this behavior is locked.
|
|
|
|
----
|
|
|
|
.. _class_ConeTwistJoint_property_twist_span:
|
|
|
|
- :ref:`float<class_float>` **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.
|
|
|
|
Method Descriptions
|
|
-------------------
|
|
|
|
.. _class_ConeTwistJoint_method_get_param:
|
|
|
|
- :ref:`float<class_float>` **get_param** **(** :ref:`Param<enum_ConeTwistJoint_Param>` param **)** |const|
|
|
|
|
----
|
|
|
|
.. _class_ConeTwistJoint_method_set_param:
|
|
|
|
- void **set_param** **(** :ref:`Param<enum_ConeTwistJoint_Param>` param, :ref:`float<class_float>` value **)**
|
|
|
|
.. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
|
|
.. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
|
|
.. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
|