Skip to content

Class: MotorJoint

A motor joint is used to control the relative motion between two bodies. A typical usage is to control the movement of a dynamic body with respect to the ground.

Extends

Constructors

Constructor

new MotorJoint(def): MotorJoint

Parameters

def

MotorJointDef

Returns

MotorJoint

Overrides

Joint.constructor

Constructor

new MotorJoint(def, bodyA, bodyB): MotorJoint

Parameters

def

MotorJointOpt

bodyA

Body

bodyB

Body

Returns

MotorJoint

Overrides

Joint.constructor

Properties

style

style: Style = {}

Styling for dev-tools.

Inherited from

Joint.style


TYPE

static TYPE: "motor-joint"

Methods

getAnchorA()

getAnchorA(): Vec2

Get the anchor point on bodyA in world coordinates.

Returns

Vec2

Overrides

Joint.getAnchorA


getAnchorB()

getAnchorB(): Vec2

Get the anchor point on bodyB in world coordinates.

Returns

Vec2

Overrides

Joint.getAnchorB


getAngularOffset()

getAngularOffset(): number

Returns

number


getBodyA()

getBodyA(): Body

Get the first body attached to this joint.

Returns

Body

Inherited from

Joint.getBodyA


getBodyB()

getBodyB(): Body

Get the second body attached to this joint.

Returns

Body

Inherited from

Joint.getBodyB


getCollideConnected()

getCollideConnected(): boolean

Get collide connected. Note: modifying the collide connect flag won't work correctly because the flag is only checked when fixture AABBs begin to overlap.

Returns

boolean

Inherited from

Joint.getCollideConnected


getCorrectionFactor()

getCorrectionFactor(): number

Get the position correction factor in the range [0,1].

Returns

number


getLinearOffset()

getLinearOffset(): Vec2

Returns

Vec2


getMaxForce()

getMaxForce(): number

Get the maximum friction force in N.

Returns

number


getMaxTorque()

getMaxTorque(): number

Get the maximum friction torque in N*m.

Returns

number


getNext()

getNext(): Joint

Get the next joint the world joint list.

Returns

Joint

Inherited from

Joint.getNext


getReactionForce()

getReactionForce(inv_dt): Vec2

Get the reaction force on bodyB at the joint anchor in Newtons.

Parameters

inv_dt

number

Returns

Vec2

Overrides

Joint.getReactionForce


getReactionTorque()

getReactionTorque(inv_dt): number

Get the reaction torque on bodyB in N*m.

Parameters

inv_dt

number

Returns

number

Overrides

Joint.getReactionTorque


getType()

getType(): string

Get the type of the concrete joint.

Returns

string

Inherited from

Joint.getType


getUserData()

getUserData(): unknown

Returns

unknown

Inherited from

Joint.getUserData


initVelocityConstraints()

initVelocityConstraints(step): void

Parameters

step

TimeStep

Returns

void

Overrides

Joint.initVelocityConstraints


isActive()

isActive(): boolean

Short-cut function to determine if either body is inactive.

Returns

boolean

Inherited from

Joint.isActive


setAngularOffset()

setAngularOffset(angularOffset): void

Set/get the target angular offset, in radians.

Parameters

angularOffset

number

Returns

void


setCorrectionFactor()

setCorrectionFactor(factor): void

Set the position correction factor in the range [0,1].

Parameters

factor

number

Returns

void


setLinearOffset()

setLinearOffset(linearOffset): void

Set/get the target linear offset, in frame A, in meters.

Parameters

linearOffset

Vec2Value

Returns

void


setMaxForce()

setMaxForce(force): void

Set the maximum friction force in N.

Parameters

force

number

Returns

void


setMaxTorque()

setMaxTorque(torque): void

Set the maximum friction torque in N*m.

Parameters

torque

number

Returns

void


setUserData()

setUserData(data): void

Parameters

data

unknown

Returns

void

Inherited from

Joint.setUserData


shiftOrigin()

shiftOrigin(newOrigin): void

Shift the origin for any points stored in world coordinates.

Parameters

newOrigin

Vec2Value

Returns

void

Inherited from

Joint.shiftOrigin


solvePositionConstraints()

solvePositionConstraints(step): boolean

This returns true if the position errors are within tolerance.

Parameters

step

TimeStep

Returns

boolean

Overrides

Joint.solvePositionConstraints


solveVelocityConstraints()

solveVelocityConstraints(step): void

Parameters

step

TimeStep

Returns

void

Overrides

Joint.solveVelocityConstraints