Class: Rectangle

Constructor

new Rectangle(Game, width, height, position, options)

Parameters:

Name	Type	Description
`Game`	Game	Game object the body should be simulated in; If you're creating a RigidBody from a Game object, like `game.Bodies.Rectangle(...)`, then you must omit this parameter.
`width`	number	Width of rectangle
`height`	number	Height of rectangle
`position`	vec	Position of body
`options`	object	RigidBody options

Source: bodies/Rectangle.js, line 14

Extends

RigidBody

Members

(readonly) nodeType

Indicates type of node. In this case, "RigidBody"

Overrides: RigidBody#nodeType
Source: physics/RigidBody.js, line 91

(readonly) mass :Number

Type:

Number

Overrides: RigidBody#mass
Source: physics/RigidBody.js, line 101

restitution :Number

Bounciness

Type:

Number

Overrides: RigidBody#restitution
Source: physics/RigidBody.js, line 106

frictionAir :Number

How much the body is always slowed down

Type:

Number

Overrides: RigidBody#frictionAir
Source: physics/RigidBody.js, line 111

frictionAngular :Number

How much body's rotation is always slowed down

Type:

Number

Overrides: RigidBody#frictionAngular
Source: physics/RigidBody.js, line 116

friction :Number

Type:

Number

Overrides: RigidBody#friction
Source: physics/RigidBody.js, line 120

(readonly) isStatic :Boolean

If the body is static (unmoving). Change through setStatic

Type:

Boolean

Overrides: RigidBody#isStatic
Source: physics/RigidBody.js, line 129

isSensor :Boolean

If the body acts like a sensor, detecting collisions while not hitting anything

Type:

Boolean

Overrides: RigidBody#isSensor
Source: physics/RigidBody.js, line 134

(readonly) hasCollisions :Boolean

If the body has any collisions. Change through setCollisions

Type:

Boolean

Overrides: RigidBody#hasCollisions
Source: physics/RigidBody.js, line 140

collisionFilter :Object

What bodies it can collide with. The layer is like what collision group the body belongs to and the mask is what layers the body will collide with. They are compared using their bits to indicate what layer it is in/collides with.
Another way to visualize it looking at the bits:
Layer: 0 1 0 1
Mask 1: 0 0 0 1 <-- collides
Mask 2: 0 0 1 0 <-- doesn't collide
Mask 3: 1 1 1 0 <-- collides
In other words, if layer & mask != 0 (bitwise and) for either of the bodies in the collision, the bodies can collide

Type:

Object

Overrides: RigidBody#collisionFilter
Source: physics/RigidBody.js, line 166

Example

// In every layer, collides with everything (the default)
body.collisionFilter = {
	layer: 0xFFFFFF,
	mask:  0xFFFFFF,
}
// In first 2 layers, collides only with 2nd layer
// So it would collide with itself and any body that has a mask in layers 1 or 2
body.collisionFilter = {
	layer: 0b0011,
	mask:  0b0010,
}

(readonly) position :vec

Position of the node

Type:

Overrides: RigidBody#position
Source: node/Node.js, line 36
To Do: Implement getPosition method and make this private

(readonly) angle :number

Angle, in radians

Type:

number

Overrides: RigidBody#angle
Source: node/Node.js, line 43
To Do: Implement getAngle method and make this private

(readonly) children :Set

Children of the node To modify, use addChild or removeChild.

Type:

Overrides: RigidBody#children
Source: node/Node.js, line 50

Methods

add() → {RigidBody}

Adds the body to its world

Overrides: RigidBody#add
Source: physics/RigidBody.js, line 273

Returns:

this

Type:: RigidBody

delete() → {RigidBody}

Removes the body from its world

Overrides: RigidBody#delete
Source: physics/RigidBody.js, line 286

Returns:

this

Type:: RigidBody

addPolygonRender(options, containeropt) → {RigidBody}

Adds a polygon render to body

Parameters:

Name	Type	Attributes	Default	Description
`options`	Object			Polygon Render options
`container`	PIXI.Container	<optional>	this.Game.Render.app.stage	Container polygon render is added to. Defaults to the main render container of the game the body is in.

Overrides: RigidBody#addPolygonRender
Source: physics/RigidBody.js, line 318

Returns:

this

Type:: RigidBody

Example

body.addPolygonRender({
	layer: 0, // Render layer, higher means it is rendered "closer" to the camera and above other objects, like CSS z-index
	visible: true,
	alpha: 1, // Opacity, between 0-1
	
	// All colors can be a hex code, rgb, rgba, or "transparent"
	background: "#ffffff80", // fill color

	border: "#ff0000", // border color
	borderWidth: 3, // How thick border is, set to 0 to disable border
	lineCap: "butt", // How border should end. Doesn't do anything for closed bodies
	lineJoin: "miter", // How border's corners should look. Same options as ctx.lineJoin property
	
	round: 0, // How rounded the polygon should look. Only works for Rectangles
});

addSprite(options, containeropt) → {RigidBody}

Adds a sprite to body

Parameters:

Name	Type	Attributes	Default	Description
`options`	Object			Sprite options
`container`	PIXI.Container	<optional>	this.Game.Render.app.stage	Container sprite is added to. Defaults to the main render container of the game the body is in.

Overrides: RigidBody#addSprite
Source: physics/RigidBody.js, line 352

Returns:

this

Type:: RigidBody

Example

body.addSprite(Render.app.stage, {
	layer: 0, // number

	visible: true,
	alpha: 1, // number between [0, 1]
	src: "path/to/sprite.png",
	
	scale: new vec(1, 1),
	width:  undefined, // number, defaults to fit body if a Rectangle or Circle, or width of image if not
	height: undefined, // number, defaults to fit body if a Rectangle or Circle, or height of image if not
});

addSpritesheet(container, options) → {RigidBody}

Adds a new Spritesheet to body

Parameters:

Name	Type	Description
`container`	PIXI.Container	Container the Spritesheet is added to
`options`	Object	Spritesheet options

Overrides: RigidBody#addSpritesheet
Source: physics/RigidBody.js, line 372

Returns:

this

Type:: RigidBody

setStatic(isStatic)

Changes if the body is static

Parameters:

Name	Type	Description
`isStatic`	boolean	If the body should be static

Overrides: RigidBody#setStatic
Source: physics/RigidBody.js, line 391

setMass(mass)

Changes the body's mass to a new value

Parameters:

Name	Type	Description
`mass`	number

Overrides: RigidBody#setMass
Source: physics/RigidBody.js, line 423

setCollisions(hasCollisions)

Changes if the body can collide with other bodies

Parameters:

Name	Type	Description
`hasCollisions`	boolean	Whether the body can collide with other bodies

Overrides: RigidBody#setCollisions
Source: physics/RigidBody.js, line 433

containsPoint(point) → {boolean}

Finds if a point is inside the body's collision shapes

Parameters:

Name	Type	Description
`point`	vec	Point to query

Overrides: RigidBody#containsPoint
Source: physics/RigidBody.js, line 462

Returns:

If the point is inside the body's vertices

Type:: boolean

setPosition(position)

Instantly sets body's position to position

Parameters:

Name	Type	Description
`position`	vec	Position the body should be

Overrides: RigidBody#setPosition
Source: physics/RigidBody.js, line 477

Example

body.setPosition(new vec(100, 100)); // Sets body's position to (100, 100)

setVelocity(velocity)

Instantly changes the body's velocity to a specific value

Parameters:

Name	Type	Description
`velocity`	vec	Velocity the body should have

Overrides: RigidBody#setVelocity
Source: physics/RigidBody.js, line 487

setAngularVelocity(velocity)

Instantly changes the body's angular velocity to a specific value

Parameters:

Name	Type	Description
`velocity`	number	Angular velocity the body should have

Overrides: RigidBody#setAngularVelocity
Source: physics/RigidBody.js, line 501

applyForce(force, deltaopt)

Applies a force to the body, ignoring mass. The body's velocity changes by force * delta

Parameters:

Name	Type	Attributes	Default	Description
`force`	vec			Amount of force to be applied, in px / sec^2
`delta`	number	<optional>	Engine.delta	Amount of time that the force is applied, in seconds. Set to 1 if applying instantaneous force

Overrides: RigidBody#applyForce
Source: physics/RigidBody.js, line 515

applyTorque(force, deltaopt)

Applies a rotational force (torque) to the body, ignoring mass. The body's angular velocity changes by force * delta

Parameters:

Name	Type	Attributes	Default	Description
`force`	number			Amount of torque to be applied, in radians / sec^2
`delta`	number	<optional>	Engine.delta	Amount of time that the force is applied, in seconds. Set to 1 if applying instantaneous force

Overrides: RigidBody#applyTorque
Source: physics/RigidBody.js, line 527

on(event, callback)

Bind a callback to an event

Parameters:

Name	Type	Description
`event`	string	Name of the event
`callback`	function	Callback run when event is fired

Overrides: RigidBody#on
Source: physics/RigidBody.js, line 575

off(event, callback)

Unbinds a callback from an event

Parameters:

Name	Type	Description
`event`	string	Name of the event
`callback`	function	Function to unbind

Overrides: RigidBody#off
Source: physics/RigidBody.js, line 588

trigger(event, …args)

Triggers an event, firing all bound callbacks

Parameters:

Name	Type	Attributes	Description
`event`	string		Name of the event
`args`	*	<repeatable>	Arguments passed to callbacks

Overrides: RigidBody#trigger
Source: physics/RigidBody.js, line 599

isAdded() → {Boolean}

Gets if the node is added

Overrides: RigidBody#isAdded
Source: node/Node.js, line 101

Returns:

if the node is added

Type:: Boolean

addChild(…children)

Adds all children to this node's children

Parameters:

Name	Type	Attributes	Description
`children`	Node	<repeatable>	Children added

Overrides: RigidBody#addChild
Source: node/Node.js, line 113

Example

let parentNode = new Node();
let childNode = new Node();
node.addChild(childNode);

removeChild(…children)

Removes all children from this node's children

Parameters:

Name	Type	Attributes	Description
`children`	Node	<repeatable>	Children removed

Overrides: RigidBody#removeChild
Source: node/Node.js, line 127

Example

let parentNode = new Node();
let childNode = new Node();
node.addChild(childNode); // node.children: Set {childNode}
node.removeChild(childNode); // node.children: Set {}

translate(positionDelta)

Shifts this node's position by positionDelta

Parameters:

Name	Type	Description
`positionDelta`	vec	Amount to shift the position

Overrides: RigidBody#translate
Source: node/Node.js, line 148

setAngle(angle)

Sets the node's angle to angle

Parameters:

Name	Type	Description
`angle`	number	Angle body should be in radians

Overrides: RigidBody#setAngle
Source: node/Node.js, line 162

Example

node.setAngle(Math.PI); // Sets node's angle to Pi radians, or 180 degrees

translateAngle(angle)

Rotates the body by angle- Relative

Parameters:

Name	Type	Description
`angle`	number	Amount the body should be rotated, in radians

Overrides: RigidBody#translateAngle
Source: node/Node.js, line 174