com.jayfella.jme.vehicle.part

Class Suspension

java.lang.Object

com.jayfella.jme.vehicle.part.Suspension

public class Suspension
extends java.lang.Object

Manage a wheel's suspension.

If you use this class, you should avoid directly invoking certain physics setters, notably:

• setWheelsDampingCompression(),
• setWheelsDampingRelaxation(), and
• setSuspensionStiffness().

Derived from the Suspension class in the Advanced Vehicles project.

Constructor Summary

Constructors

Constructor and Description
Suspension(com.jme3.bullet.objects.VehicleWheel vehicleWheel) Instantiate a suspension with reasonable parameter settings.

Method Summary

Modifier and Type	Method and Description
float	getCompressDamping() Determine the damping for compression.
float	getMaxForce() Determine the maximum force exerted by this suspension.
float	getRelaxDamping() Determine the damping for relaxation.
float	getRestLength() Determine the rest length of this suspension.
float	getStiffness() Determine the stiffness of this suspension.
void	setCompressDamping(float dampingRatio) Alter the damping for compression.
void	setMaxForce(float maxForce) Alter the maximum force exerted by this suspension.
void	setMaxTravelCm(float travelCm) Alter the maximum travel distance.
void	setRelaxDamping(float dampingRatio) Alter the damping for relaxation.
void	setRestLength(float restLength) Alter the length of this suspension.
void	setStiffness(float stiffness) Alter the stiffness of this suspension.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Suspension

public Suspension(com.jme3.bullet.objects.VehicleWheel vehicleWheel)

Instantiate a suspension with reasonable parameter settings.

Parameters:

vehicleWheel - the physics object to manage (not null, alias created)

Method Detail

getCompressDamping

public float getCompressDamping()

Determine the damping for compression.

Returns:

the damping ratio (0=undamped, 1=critically damped)

getMaxForce

public float getMaxForce()

Determine the maximum force exerted by this suspension.

Returns:

the maximum force (in Newtons)

getRelaxDamping

public float getRelaxDamping()

Determine the damping for relaxation.

Returns:

the damping ratio (0=undamped, 1=critically damped)

getRestLength

public float getRestLength()

Determine the rest length of this suspension.

Returns:

the length (in physics-space units)

getStiffness

public float getStiffness()

Determine the stiffness of this suspension.

Returns:

the stiffness constant (10→off-road buggy, 50→sports car, 200→Formula-1 race car)

setCompressDamping

public void setCompressDamping(float dampingRatio)

Alter the damping for compression.

Parameters:

dampingRatio - the desired damping ratio (0=undamped, 1=critically damped, default=0.2)

setMaxForce

public void setMaxForce(float maxForce)

Alter the maximum force exerted by this suspension.

Increase this if the suspension cannot handle the weight of your vehicle.

Parameters:

maxForce - the desired maximum force (default=10_000)

setMaxTravelCm

public void setMaxTravelCm(float travelCm)

Alter the maximum travel distance. Note that the units are centimeters ONLY if the physics-space unit is exactly one meter.

Parameters:

travelCm - the desired maximum amount the suspension can be compressed or expanded, relative to its rest length (in hundredths of a physics-space unit, default=500)

setRelaxDamping

public void setRelaxDamping(float dampingRatio)

Alter the damping for relaxation.

Parameters:

dampingRatio - the desired damping ratio (0=undamped, 1=critically damped, default=0.3)

setRestLength

public void setRestLength(float restLength)

Alter the length of this suspension. Bullet updates the length on every physics tick. TODO so remove this?

Parameters:

restLength - the desired length (in physics-space units)

setStiffness

public void setStiffness(float stiffness)

Alter the stiffness of this suspension.

Parameters:

stiffness - the desired stiffness constant (10→off-road buggy, 50→sports car, 200→Formula-1 race car, default=25)