| github_url: | hide |
|---|
Inherits: :ref:`Joint2D<class_Joint2D>` < :ref:`Node2D<class_Node2D>` < :ref:`CanvasItem<class_CanvasItem>` < :ref:`Node<class_Node>` < :ref:`Object<class_Object>`
A physics joint that connects two 2D physics bodies with a spring-like force.
.. rst-class:: classref-introduction-group
A physics joint that connects two 2D physics bodies with a spring-like force. This resembles a spring that always wants to stretch to a given length.
.. rst-class:: classref-reftable-group
.. rst-class:: classref-section-separator
.. rst-class:: classref-descriptions-group
.. rst-class:: classref-property
:ref:`float<class_float>` damping = 1.0
.. rst-class:: classref-property-setget
- void set_damping ( :ref:`float<class_float>` value )
- :ref:`float<class_float>` get_damping ( )
The spring joint's damping ratio. A value between 0 and 1. When the two bodies move into different directions the system tries to align them to the spring axis again. A high damping value forces the attached bodies to align faster.
.. rst-class:: classref-item-separator
.. rst-class:: classref-property
:ref:`float<class_float>` length = 50.0
.. rst-class:: classref-property-setget
- void set_length ( :ref:`float<class_float>` value )
- :ref:`float<class_float>` get_length ( )
The spring joint's maximum length. The two attached bodies cannot stretch it past this value.
.. rst-class:: classref-item-separator
.. rst-class:: classref-property
:ref:`float<class_float>` rest_length = 0.0
.. rst-class:: classref-property-setget
- void set_rest_length ( :ref:`float<class_float>` value )
- :ref:`float<class_float>` get_rest_length ( )
When the bodies attached to the spring joint move they stretch or squash it. The joint always tries to resize towards this length.
.. rst-class:: classref-item-separator
.. rst-class:: classref-property
:ref:`float<class_float>` stiffness = 20.0
.. rst-class:: classref-property-setget
- void set_stiffness ( :ref:`float<class_float>` value )
- :ref:`float<class_float>` get_stiffness ( )
The higher the value, the less the bodies attached to the joint will deform it. The joint applies an opposing force to the bodies, the product of the stiffness multiplied by the size difference from its resting length.