Box2dWheelJoint

Box2D Wheel Joint

  • Provides two degrees of freedom: translation along an axis fixed in objectA and rotation
  • You can use a joint limit to restrict the range of motion
  • You can use a joint motor to drive the motion or to model joint friction
  • This joint is designed for vehicle suspensions

Constructor

new Box2dWheelJoint(objectA, objectB, anchor, worldAxis, collideopt)

Create a wheel joint

Parameters:
NameTypeAttributesDefaultDescription
objectABox2dObject
objectBBox2dObject
anchorVector2
worldAxisVector2
collideboolean<optional>
false

Extends

Methods

destroy()

Destroy this joint

enableMotor(enableopt)

Enable/disable the joint motor

Parameters:
NameTypeAttributesDefaultDescription
enableboolean<optional>
true

getAnchorA() → {Vector2}

Get the first anchor for this joint in world coordinates

Returns:
Type: 
Vector2

getAnchorB() → {Vector2}

Get the second anchor for this joint in world coordinates

Returns:
Type: 
Vector2

getCollideConnected() → {boolean}

Check if the connected bodies should collide

Returns:
Type: 
boolean

getJointSpeed() → {number}

Get the current joint translation speed

Returns:
Type: 
number

getJointTranslation() → {number}

Get the current joint translation

Returns:
Type: 
number

getLocalAnchorA() → {Vector2}

Get the local anchor point relative to objectA's origin

Returns:
Type: 
Vector2

getLocalAnchorB() → {Vector2}

Get the local anchor point relative to objectB's origin

Returns:
Type: 
Vector2

getLocalAxisA() → {Vector2}

Get the local joint axis relative to bodyA

Returns:
Type: 
Vector2

getMaxMotorTorque() → {number}

Get the max motor torque

Returns:
Type: 
number

getMotorSpeed() → {number}

Get the motor speed

Returns:
Type: 
number

getMotorTorque() → {number}

Get the motor torque for a time step

Returns:
Type: 
number

getObjectA() → {Box2dObject}

Get the first object attached to this joint

Returns:
Type: 
Box2dObject

getObjectB() → {Box2dObject}

Get the second object attached to this joint

Returns:
Type: 
Box2dObject

getReactionForce(time) → {Vector2}

Get the reaction force on bodyB at the joint anchor given a time step

Parameters:
NameTypeDescription
timenumber
Returns:
Type: 
Vector2

getReactionTorque(time) → {number}

Get the reaction torque on bodyB in N*m given a time step

Parameters:
NameTypeDescription
timenumber
Returns:
Type: 
number

getSpringDampingRatio() → {number}

Get the spring damping ratio

Returns:
Type: 
number

getSpringFrequencyHz() → {number}

Get the spring frequency in Hertz

Returns:
Type: 
number

isActive() → {boolean}

Check if either connected body is active

Returns:
Type: 
boolean

isMotorEnabled() → {boolean}

Is the joint motor enabled?

Returns:
Type: 
boolean

setMaxMotorTorque(torque)

Set the maximum motor torque

Parameters:
NameTypeDescription
torquenumber

setMotorSpeed(speed)

Set the motor speed

Parameters:
NameTypeDescription
speednumber

setSpringDampingRatio(ratio)

Set the spring damping ratio

Parameters:
NameTypeDescription
rationumber

setSpringFrequencyHz(hz)

Set the spring frequency in Hertz

Parameters:
NameTypeDescription
hznumber