SliderJoint:getSpring
EditReturns the spring parameters of the SliderJoint. Use this to make the position limits of the slider "soft". When the motor is active, a separate set of spring parameters can be set on the motor, see SliderJoint:setMotorSpring
.
frequency, damping = SliderJoint:getSpring()
Arguments
None
Returns
Name | Type | Description |
frequency | number | The frequency of the spring, in hertz. Higher frequencies make the spring more stiff. When zero, the spring is disabled. |
damping | number | The damping ratio of the spring. |
Notes
Higher frequencies make the spring more stiff. When zero (the default), the spring is disabled and the limits will be as stiff as possible.
The damping ratio controls how quickly the oscillation slows down:
- Undamped: Zero damping will cause the spring to oscillate forever. (Note that the spring may still lose a small amount of energy over time).
- Underdamped: Damping less than one results in a system that is underdamped. The spring will oscillate around the target, but the oscillations will decay over time, eventually stabilizing at the target.
- Overdamped: Damping greater than one will not have any oscillation, and the spring will take extra time to reach the target.
- Critical Damping: When the damping is exactly 1.0, there is no oscillation and the spring takes the minimum amount of time to reach the target (based on the frequency).
The default damping ratio is 1.