/** * @author Richard Davey * @copyright 2018 Photon Storm Ltd. * @license {@link https://github.com/photonstorm/phaser/blob/master/license.txt|MIT License} */ var CircleContains = require('../../geom/circle/Contains'); var Class = require('../../utils/Class'); var CONST = require('./const'); var RadToDeg = require('../../math/RadToDeg'); var Rectangle = require('../../geom/rectangle/Rectangle'); var RectangleContains = require('../../geom/rectangle/Contains'); var Vector2 = require('../../math/Vector2'); /** * @typedef {object} ArcadeBodyBounds * * @property {number} x - The left edge. * @property {number} y - The upper edge. * @property {number} right - The right edge. * @property {number} bottom - The lower edge. */ /** * @typedef {object} ArcadeBodyCollision * * @property {boolean} none - True if the Body is not colliding. * @property {boolean} up - True if the Body is colliding on its upper edge. * @property {boolean} down - True if the Body is colliding on its lower edge. * @property {boolean} left - True if the Body is colliding on its left edge. * @property {boolean} right - True if the Body is colliding on its right edge. */ /** * @classdesc * A Dynamic Arcade Body. * * Its static counterpart is {@link Phaser.Physics.Arcade.StaticBody}. * * @class Body * @memberOf Phaser.Physics.Arcade * @constructor * @since 3.0.0 * * @param {Phaser.Physics.Arcade.World} world - The Arcade Physics simulation this Body belongs to. * @param {Phaser.GameObjects.GameObject} gameObject - The Game Object this Body belongs to. */ var Body = new Class({ initialize: function Body (world, gameObject) { var width = (gameObject.width) ? gameObject.width : 64; var height = (gameObject.height) ? gameObject.height : 64; /** * The Arcade Physics simulation this Body belongs to. * * @name Phaser.Physics.Arcade.Body#world * @type {Phaser.Physics.Arcade.World} * @since 3.0.0 */ this.world = world; /** * The Game Object this Body belongs to. * * @name Phaser.Physics.Arcade.Body#gameObject * @type {Phaser.GameObjects.GameObject} * @since 3.0.0 */ this.gameObject = gameObject; /** * Transformations applied to this Body. * * @name Phaser.Physics.Arcade.Body#transform * @type {object} * @since 3.4.0 */ this.transform = { x: gameObject.x, y: gameObject.y, rotation: gameObject.angle, scaleX: gameObject.scaleX, scaleY: gameObject.scaleY, displayOriginX: gameObject.displayOriginX, displayOriginY: gameObject.displayOriginY }; /** * Whether the Body's boundary is drawn to the debug display. * * @name Phaser.Physics.Arcade.Body#debugShowBody * @type {boolean} * @since 3.0.0 */ this.debugShowBody = world.defaults.debugShowBody; /** * Whether the Body's velocity is drawn to the debug display. * * @name Phaser.Physics.Arcade.Body#debugShowVelocity * @type {boolean} * @since 3.0.0 */ this.debugShowVelocity = world.defaults.debugShowVelocity; /** * The color of this Body on the debug display. * * @name Phaser.Physics.Arcade.Body#debugBodyColor * @type {integer} * @since 3.0.0 */ this.debugBodyColor = world.defaults.bodyDebugColor; /** * Whether this Body is updated by the physics simulation. * * @name Phaser.Physics.Arcade.Body#enable * @type {boolean} * @default true * @since 3.0.0 */ this.enable = true; /** * Whether this Body's boundary is circular (true) or rectangular (false). * * @name Phaser.Physics.Arcade.Body#isCircle * @type {boolean} * @default false * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#setCircle */ this.isCircle = false; /** * If this Body is circular, this is the unscaled radius of the Body's boundary, as set by setCircle(), in source pixels. * The true radius is equal to `halfWidth`. * * @name Phaser.Physics.Arcade.Body#radius * @type {number} * @default 0 * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#setCircle */ this.radius = 0; /** * The offset of this Body's position from its Game Object's position, in source pixels. * * @name Phaser.Physics.Arcade.Body#offset * @type {Phaser.Math.Vector2} * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#setOffset */ this.offset = new Vector2(); /** * The position of this Body within the simulation. * * @name Phaser.Physics.Arcade.Body#position * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.position = new Vector2(gameObject.x, gameObject.y); /** * The position of this Body during the previous step. * * @name Phaser.Physics.Arcade.Body#prev * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.prev = new Vector2(gameObject.x, gameObject.y); /** * Whether this Body's `rotation` is affected by its angular acceleration and angular velocity. * * @name Phaser.Physics.Arcade.Body#allowRotation * @type {boolean} * @default true * @since 3.0.0 */ this.allowRotation = true; /** * This body's rotation, in degrees, based on its angular acceleration and angular velocity. * The Body's rotation controls the `angle` of its Game Object. * It doesn't rotate the Body's boundary, which is always an axis-aligned rectangle or a circle. * * @name Phaser.Physics.Arcade.Body#rotation * @type {number} * @since 3.0.0 */ this.rotation = gameObject.angle; /** * The Body's rotation, in degrees, during the previous step. * * @name Phaser.Physics.Arcade.Body#preRotation * @type {number} * @since 3.0.0 */ this.preRotation = gameObject.angle; /** * The width of the Body's boundary, in pixels. * If the Body is circular, this is also the Body's diameter. * * @name Phaser.Physics.Arcade.Body#width * @type {number} * @default 64 * @since 3.0.0 */ this.width = width; /** * The height of the Body's boundary, in pixels. * If the Body is circular, this is also the Body's diameter. * * @name Phaser.Physics.Arcade.Body#height * @type {number} * @default 64 * @since 3.0.0 */ this.height = height; /** * The unscaled width of the Body, in source pixels, as set by setSize(). * The default is the width of the Body's Game Object's texture frame. * * @name Phaser.Physics.Arcade.Body#sourceWidth * @type {number} * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#setSize */ this.sourceWidth = width; /** * The unscaled height of the Body, in source pixels, as set by setSize(). * The default is the height of the Body's Game Object's texture frame. * * @name Phaser.Physics.Arcade.Body#sourceHeight * @type {number} * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#setSize */ this.sourceHeight = height; if (gameObject.frame) { this.sourceWidth = gameObject.frame.realWidth; this.sourceHeight = gameObject.frame.realHeight; } /** * Half the Body's width, in pixels. * * @name Phaser.Physics.Arcade.Body#halfWidth * @type {number} * @since 3.0.0 */ this.halfWidth = Math.abs(width / 2); /** * Half the Body's height, in pixels. * * @name Phaser.Physics.Arcade.Body#halfHeight * @type {number} * @since 3.0.0 */ this.halfHeight = Math.abs(height / 2); /** * The center of the Body's boundary. * The midpoint of its `position` (top-left corner) and its bottom-right corner. * * @name Phaser.Physics.Arcade.Body#center * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.center = new Vector2(gameObject.x + this.halfWidth, gameObject.y + this.halfHeight); /** * The Body's velocity, in pixels per second. * * @name Phaser.Physics.Arcade.Body#velocity * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.velocity = new Vector2(); /** * The Body's calculated velocity, in pixels per second, at the last step. * * @name Phaser.Physics.Arcade.Body#newVelocity * @type {Phaser.Math.Vector2} * @readOnly * @since 3.0.0 */ this.newVelocity = new Vector2(); /** * The Body's absolute maximum change in position, in pixels per step. * * @name Phaser.Physics.Arcade.Body#deltaMax * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.deltaMax = new Vector2(); /** * The Body's change in velocity, in pixels per second squared. * * @name Phaser.Physics.Arcade.Body#acceleration * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.acceleration = new Vector2(); /** * Whether this Body's velocity is affected by its `drag`. * * @name Phaser.Physics.Arcade.Body#allowDrag * @type {boolean} * @default true * @since 3.0.0 */ this.allowDrag = true; /** * Absolute loss of velocity due to movement, in pixels per second squared. * The x and y components are applied separately. * * When `useDamping` is true, this is 1 minus the damping factor. * A value of 1 means the Body loses no velocity. * A value of 0.95 means the Body loses 5% of its velocity per step. * A value of 0.5 means the Body loses 50% of its velocity per step. * * Drag is applied only when `acceleration` is zero. * * @name Phaser.Physics.Arcade.Body#drag * @type {(Phaser.Math.Vector2|number)} * @since 3.0.0 */ this.drag = new Vector2(); /** * Whether this Body's position is affected by gravity (local or world). * * @name Phaser.Physics.Arcade.Body#allowGravity * @type {boolean} * @default true * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#gravity * @see Phaser.Physics.Arcade.World#gravity */ this.allowGravity = true; /** * Acceleration due to gravity (specific to this Body), in pixels per second squared. * Total gravity is the sum of this vector and the simulation's `gravity`. * * @name Phaser.Physics.Arcade.Body#gravity * @type {Phaser.Math.Vector2} * @since 3.0.0 * @see Phaser.Physics.Arcade.World#gravity */ this.gravity = new Vector2(); /** * Rebound following a collision, relative to 1. * * @name Phaser.Physics.Arcade.Body#bounce * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.bounce = new Vector2(); /** * Rebound following a collision with the world boundary, relative to 1. * If null, `bounce` is used instead. * * @name Phaser.Physics.Arcade.Body#worldBounce * @type {?Phaser.Math.Vector2} * @default null * @since 3.0.0 */ this.worldBounce = null; // If true this Body will dispatch events /** * Whether the simulation emits a `worldbounds` event when this Body collides with the world boundary (and `collideWorldBounds` is also true). * * @name Phaser.Physics.Arcade.Body#onWorldBounds * @type {boolean} * @default false * @since 3.0.0 * @see Phaser.Physics.Arcade.World#event:worldbounds */ this.onWorldBounds = false; /** * Whether the simulation emits a `collide` event when this Body collides with another. * * @name Phaser.Physics.Arcade.Body#onCollide * @type {boolean} * @default false * @since 3.0.0 * @see Phaser.Physics.Arcade.World#event:collide */ this.onCollide = false; /** * Whether the simulation emits an `overlap` event when this Body overlaps with another. * * @name Phaser.Physics.Arcade.Body#onOverlap * @type {boolean} * @default false * @since 3.0.0 * @see Phaser.Physics.Arcade.World#event:overlap */ this.onOverlap = false; /** * The Body's absolute maximum velocity, in pixels per second. * * This limits the Body's actual rate of movement but not its `velocity` values (which can still exceed `maxVelocity`). * * @name Phaser.Physics.Arcade.Body#maxVelocity * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.maxVelocity = new Vector2(10000, 10000); /** * If this Body is `immovable` and in motion, `friction` is the proportion of this Body's motion received by the riding Body on each axis, relative to 1. * The default value (1, 0) moves the riding Body horizontally in equal proportion to this Body and vertically not at all. * The horizontal component (x) is applied only when two colliding Bodies are separated vertically. * The vertical component (y) is applied only when two colliding Bodies are separated horizontally. * * @name Phaser.Physics.Arcade.Body#friction * @type {Phaser.Math.Vector2} * @since 3.0.0 */ this.friction = new Vector2(1, 0); /** * If this Body is using `drag` for deceleration this property controls how the drag is applied. * If set to `true` drag will use a damping effect rather than a linear approach. If you are * creating a game where the Body moves freely at any angle (i.e. like the way the ship moves in * the game Asteroids) then you will get a far smoother and more visually correct deceleration * by using damping, avoiding the axis-drift that is prone with linear deceleration. * * If you enable this property then you should use far smaller `drag` values than with linear, as * they are used as a multiplier on the velocity. Values such as 0.95 will give a nice slow * deceleration, where-as smaller values, such as 0.5 will stop an object almost immediately. * * @name Phaser.Physics.Arcade.Body#useDamping * @type {boolean} * @default false * @since 3.10.0 */ this.useDamping = false; /** * The rate of change of this Body's `rotation`, in degrees per second. * * @name Phaser.Physics.Arcade.Body#angularVelocity * @type {number} * @default 0 * @since 3.0.0 */ this.angularVelocity = 0; /** * The Body's angular acceleration (change in angular velocity), in degrees per second squared. * * @name Phaser.Physics.Arcade.Body#angularAcceleration * @type {number} * @default 0 * @since 3.0.0 */ this.angularAcceleration = 0; /** * Loss of angular velocity due to angular movement, in degrees per second. * * Angular drag is applied only when angular acceleration is zero. * * @name Phaser.Physics.Arcade.Body#angularDrag * @type {number} * @default 0 * @since 3.0.0 */ this.angularDrag = 0; /** * The Body's maximum angular velocity, in degrees per second. * * @name Phaser.Physics.Arcade.Body#maxAngular * @type {number} * @default 1000 * @since 3.0.0 */ this.maxAngular = 1000; /** * The Body's inertia, relative to a default unit (1). * With `bounce`, this affects the exchange of momentum (velocities) during collisions. * * @name Phaser.Physics.Arcade.Body#mass * @type {number} * @default 1 * @since 3.0.0 */ this.mass = 1; /** * The calculated angle of this Body's velocity vector, in degrees, during the last step. * * @name Phaser.Physics.Arcade.Body#angle * @type {number} * @default 0 * @since 3.0.0 */ this.angle = 0; /** * The calculated magnitude of the Body's velocity, in pixels per second, during the last step. * * @name Phaser.Physics.Arcade.Body#speed * @type {number} * @default 0 * @since 3.0.0 */ this.speed = 0; /** * The direction of the Body's velocity, as calculated during the last step. * If the Body is moving on both axes (diagonally), this describes motion on the vertical axis only. * * @name Phaser.Physics.Arcade.Body#facing * @type {integer} * @since 3.0.0 */ this.facing = CONST.FACING_NONE; /** * Whether this Body can be moved by collisions with another Body. * * @name Phaser.Physics.Arcade.Body#immovable * @type {boolean} * @default false * @since 3.0.0 */ this.immovable = false; /** * Whether the Body's position and rotation are affected by its velocity, acceleration, drag, and gravity. * * @name Phaser.Physics.Arcade.Body#moves * @type {boolean} * @default true * @since 3.0.0 */ this.moves = true; /** * A flag disabling the default horizontal separation of colliding bodies. * Pass your own `processHandler` to the collider. * * @name Phaser.Physics.Arcade.Body#customSeparateX * @type {boolean} * @default false * @since 3.0.0 */ this.customSeparateX = false; /** * A flag disabling the default vertical separation of colliding bodies. * Pass your own `processHandler` to the collider. * * @name Phaser.Physics.Arcade.Body#customSeparateY * @type {boolean} * @default false * @since 3.0.0 */ this.customSeparateY = false; /** * The amount of horizontal overlap (before separation), if this Body is colliding with another. * * @name Phaser.Physics.Arcade.Body#overlapX * @type {number} * @default 0 * @since 3.0.0 */ this.overlapX = 0; /** * The amount of vertical overlap (before separation), if this Body is colliding with another. * * @name Phaser.Physics.Arcade.Body#overlapY * @type {number} * @default 0 * @since 3.0.0 */ this.overlapY = 0; /** * The amount of overlap (before separation), if this Body is circular and colliding with another circular body. * * @name Phaser.Physics.Arcade.Body#overlapR * @type {number} * @default 0 * @since 3.0.0 */ this.overlapR = 0; /** * Whether this Body is overlapped with another and both have zero velocity. * * @name Phaser.Physics.Arcade.Body#embedded * @type {boolean} * @default false * @since 3.0.0 */ this.embedded = false; /** * Whether this Body interacts with the world boundary. * * @name Phaser.Physics.Arcade.Body#collideWorldBounds * @type {boolean} * @default false * @since 3.0.0 */ this.collideWorldBounds = false; /** * Whether this Body is checked for collisions and for which directions. * You can set `checkCollision.none = false` to disable collision checks. * * @name Phaser.Physics.Arcade.Body#checkCollision * @type {ArcadeBodyCollision} * @since 3.0.0 */ this.checkCollision = { none: false, up: true, down: true, left: true, right: true }; /** * Whether this Body is colliding with another and in which direction. * * @name Phaser.Physics.Arcade.Body#touching * @type {ArcadeBodyCollision} * @since 3.0.0 */ this.touching = { none: true, up: false, down: false, left: false, right: false }; /** * Whether this Body was colliding with another during the last step, and in which direction. * * @name Phaser.Physics.Arcade.Body#wasTouching * @type {ArcadeBodyCollision} * @since 3.0.0 */ this.wasTouching = { none: true, up: false, down: false, left: false, right: false }; /** * Whether this Body is colliding with a tile or the world boundary. * * @name Phaser.Physics.Arcade.Body#blocked * @type {ArcadeBodyCollision} * @since 3.0.0 */ this.blocked = { none: true, up: false, down: false, left: false, right: false }; /** * Whether to automatically synchronize this Body's dimensions to the dimensions of its Game Object's visual bounds. * * @name Phaser.Physics.Arcade.Body#syncBounds * @type {boolean} * @default false * @since 3.0.0 * @see Phaser.GameObjects.Components.GetBounds#getBounds */ this.syncBounds = false; /** * Whether this Body is being moved by the `moveTo` or `moveFrom` methods. * * @name Phaser.Physics.Arcade.Body#isMoving * @type {boolean} * @default false * @since 3.0.0 */ this.isMoving = false; /** * Whether this Body's movement by `moveTo` or `moveFrom` will be stopped by collisions with other bodies. * * @name Phaser.Physics.Arcade.Body#stopVelocityOnCollide * @type {boolean} * @default true * @since 3.0.0 */ this.stopVelocityOnCollide = true; // read-only /** * The Body's physics type (dynamic or static). * * @name Phaser.Physics.Arcade.Body#physicsType * @type {integer} * @readOnly * @since 3.0.0 */ this.physicsType = CONST.DYNAMIC_BODY; /** * Whether the Body's position needs updating from its Game Object. * * @name Phaser.Physics.Arcade.Body#_reset * @type {boolean} * @private * @default true * @since 3.0.0 */ this._reset = true; /** * Cached horizontal scale of the Body's Game Object. * * @name Phaser.Physics.Arcade.Body#_sx * @type {number} * @private * @since 3.0.0 */ this._sx = gameObject.scaleX; /** * Cached vertical scale of the Body's Game Object. * * @name Phaser.Physics.Arcade.Body#_sy * @type {number} * @private * @since 3.0.0 */ this._sy = gameObject.scaleY; /** * The calculated change in the Body's horizontal position during the last step. * * @name Phaser.Physics.Arcade.Body#_dx * @type {number} * @private * @default 0 * @since 3.0.0 */ this._dx = 0; /** * The calculated change in the Body's vertical position during the last step. * * @name Phaser.Physics.Arcade.Body#_dy * @type {number} * @private * @default 0 * @since 3.0.0 */ this._dy = 0; /** * Stores the Game Object's bounds. * * @name Phaser.Physics.Arcade.Body#_bounds * @type {Phaser.Geom.Rectangle} * @private * @since 3.0.0 */ this._bounds = new Rectangle(); }, /** * Updates this Body's transform, dimensions, and position from its Game Object. * * @method Phaser.Physics.Arcade.Body#updateBounds * @since 3.0.0 */ updateBounds: function () { var sprite = this.gameObject; // Container? var transform = this.transform; if (sprite.parentContainer) { var matrix = sprite.getWorldTransformMatrix(this.world._tempMatrix, this.world._tempMatrix2); transform.x = matrix.tx; transform.y = matrix.ty; transform.rotation = RadToDeg(matrix.rotation); transform.scaleX = matrix.scaleX; transform.scaleY = matrix.scaleY; } else { transform.x = sprite.x; transform.y = sprite.y; transform.rotation = sprite.angle; transform.scaleX = sprite.scaleX; transform.scaleY = sprite.scaleY; } var recalc = false; if (this.syncBounds) { var b = sprite.getBounds(this._bounds); this.width = b.width; this.height = b.height; recalc = true; } else { var asx = Math.abs(transform.scaleX); var asy = Math.abs(transform.scaleY); if (this._sx !== asx || this._sy !== asy) { this.width = this.sourceWidth * asx; this.height = this.sourceHeight * asy; this._sx = asx; this._sy = asy; recalc = true; } } if (recalc) { this.halfWidth = Math.floor(this.width / 2); this.halfHeight = Math.floor(this.height / 2); this.updateCenter(); } }, /** * Updates the Body's `center` from its `position`, `width`, and `height`. * * @method Phaser.Physics.Arcade.Body#updateCenter * @since 3.0.0 */ updateCenter: function () { this.center.set(this.position.x + this.halfWidth, this.position.y + this.halfHeight); }, /** * Updates the Body. * * @method Phaser.Physics.Arcade.Body#update * @fires Phaser.Physics.Arcade.World#worldbounds * @since 3.0.0 * * @param {number} delta - The delta time, in ms, elapsed since the last frame. */ update: function (delta) { // Store and reset collision flags this.wasTouching.none = this.touching.none; this.wasTouching.up = this.touching.up; this.wasTouching.down = this.touching.down; this.wasTouching.left = this.touching.left; this.wasTouching.right = this.touching.right; this.touching.none = true; this.touching.up = false; this.touching.down = false; this.touching.left = false; this.touching.right = false; this.blocked.none = true; this.blocked.up = false; this.blocked.down = false; this.blocked.left = false; this.blocked.right = false; this.overlapR = 0; this.overlapX = 0; this.overlapY = 0; this.embedded = false; // Updates the transform values this.updateBounds(); var sprite = this.transform; this.position.x = sprite.x + sprite.scaleX * (this.offset.x - sprite.displayOriginX); this.position.y = sprite.y + sprite.scaleY * (this.offset.y - sprite.displayOriginY); this.updateCenter(); this.rotation = sprite.rotation; this.preRotation = this.rotation; if (this._reset) { this.prev.x = this.position.x; this.prev.y = this.position.y; } if (this.moves) { this.world.updateMotion(this, delta); var vx = this.velocity.x; var vy = this.velocity.y; this.newVelocity.set(vx * delta, vy * delta); this.position.add(this.newVelocity); this.updateCenter(); this.angle = Math.atan2(vy, vx); this.speed = Math.sqrt(vx * vx + vy * vy); // Now the State update will throw collision checks at the Body // And finally we'll integrate the new position back to the Sprite in postUpdate if (this.collideWorldBounds && this.checkWorldBounds() && this.onWorldBounds) { this.world.emit('worldbounds', this, this.blocked.up, this.blocked.down, this.blocked.left, this.blocked.right); } } this._dx = this.position.x - this.prev.x; this._dy = this.position.y - this.prev.y; }, /** * Feeds the Body results back into the parent Game Object. * * @method Phaser.Physics.Arcade.Body#postUpdate * @since 3.0.0 * * @param {boolean} resetDelta - Reset the delta properties? */ postUpdate: function () { this._dx = this.position.x - this.prev.x; this._dy = this.position.y - this.prev.y; if (this.moves) { if (this.deltaMax.x !== 0 && this._dx !== 0) { if (this._dx < 0 && this._dx < -this.deltaMax.x) { this._dx = -this.deltaMax.x; } else if (this._dx > 0 && this._dx > this.deltaMax.x) { this._dx = this.deltaMax.x; } } if (this.deltaMax.y !== 0 && this._dy !== 0) { if (this._dy < 0 && this._dy < -this.deltaMax.y) { this._dy = -this.deltaMax.y; } else if (this._dy > 0 && this._dy > this.deltaMax.y) { this._dy = this.deltaMax.y; } } this.gameObject.x += this._dx; this.gameObject.y += this._dy; this._reset = true; } if (this._dx < 0) { this.facing = CONST.FACING_LEFT; } else if (this._dx > 0) { this.facing = CONST.FACING_RIGHT; } if (this._dy < 0) { this.facing = CONST.FACING_UP; } else if (this._dy > 0) { this.facing = CONST.FACING_DOWN; } if (this.allowRotation) { this.gameObject.angle += this.deltaZ(); } this.prev.x = this.position.x; this.prev.y = this.position.y; }, /** * Checks for collisions between this Body and the world boundary and separates them. * * @method Phaser.Physics.Arcade.Body#checkWorldBounds * @since 3.0.0 * * @return {boolean} True if this Body is colliding with the world boundary. */ checkWorldBounds: function () { var pos = this.position; var bounds = this.world.bounds; var check = this.world.checkCollision; var bx = (this.worldBounce) ? -this.worldBounce.x : -this.bounce.x; var by = (this.worldBounce) ? -this.worldBounce.y : -this.bounce.y; if (pos.x < bounds.x && check.left) { pos.x = bounds.x; this.velocity.x *= bx; this.blocked.left = true; this.blocked.none = false; } else if (this.right > bounds.right && check.right) { pos.x = bounds.right - this.width; this.velocity.x *= bx; this.blocked.right = true; this.blocked.none = false; } if (pos.y < bounds.y && check.up) { pos.y = bounds.y; this.velocity.y *= by; this.blocked.up = true; this.blocked.none = false; } else if (this.bottom > bounds.bottom && check.down) { pos.y = bounds.bottom - this.height; this.velocity.y *= by; this.blocked.down = true; this.blocked.none = false; } return !this.blocked.none; }, /** * Sets the offset of the Body's position from its Game Object's position. * * @method Phaser.Physics.Arcade.Body#setOffset * @since 3.0.0 * * @param {number} x - The horizontal offset, in source pixels. * @param {number} [y=x] - The vertical offset, in source pixels. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setOffset: function (x, y) { if (y === undefined) { y = x; } this.offset.set(x, y); return this; }, /** * Sizes and positions this Body's boundary, as a rectangle. * Modifies the Body `offset` if `center` is true (the default). * Resets the width and height to match current frame, if no width and height provided and a frame is found. * * @method Phaser.Physics.Arcade.Body#setSize * @since 3.0.0 * * @param {integer} [width] - The width of the Body in pixels. Cannot be zero. If not given, and the parent Game Object has a frame, it will use the frame width. * @param {integer} [height] - The height of the Body in pixels. Cannot be zero. If not given, and the parent Game Object has a frame, it will use the frame height. * @param {boolean} [center=true] - Modify the Body's `offset`, placing the Body's center on its Game Object's center. Only works if the Game Object has the `getCenter` method. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setSize: function (width, height, center) { if (center === undefined) { center = true; } var gameObject = this.gameObject; if (!width && gameObject.frame) { width = gameObject.frame.realWidth; } if (!height && gameObject.frame) { height = gameObject.frame.realHeight; } this.sourceWidth = width; this.sourceHeight = height; this.width = this.sourceWidth * this._sx; this.height = this.sourceHeight * this._sy; this.halfWidth = Math.floor(this.width / 2); this.halfHeight = Math.floor(this.height / 2); this.updateCenter(); if (center && gameObject.getCenter) { var ox = gameObject.displayWidth / 2; var oy = gameObject.displayHeight / 2; this.offset.set(ox - this.halfWidth, oy - this.halfHeight); } this.isCircle = false; this.radius = 0; return this; }, /** * Sizes and positions this Body's boundary, as a circle. * * @method Phaser.Physics.Arcade.Body#setCircle * @since 3.0.0 * * @param {number} radius - The radius of the Body, in source pixels. * @param {number} [offsetX] - The horizontal offset of the Body from its Game Object, in source pixels. * @param {number} [offsetY] - The vertical offset of the Body from its Game Object, in source pixels. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setCircle: function (radius, offsetX, offsetY) { if (offsetX === undefined) { offsetX = this.offset.x; } if (offsetY === undefined) { offsetY = this.offset.y; } if (radius > 0) { this.isCircle = true; this.radius = radius; this.sourceWidth = radius * 2; this.sourceHeight = radius * 2; this.width = this.sourceWidth * this._sx; this.height = this.sourceHeight * this._sy; this.halfWidth = Math.floor(this.width / 2); this.halfHeight = Math.floor(this.height / 2); this.offset.set(offsetX, offsetY); this.updateCenter(); } else { this.isCircle = false; } return this; }, /** * Resets this Body to the given coordinates. Also positions its parent Game Object to the same coordinates. * If the Body had any velocity or acceleration it is lost as a result of calling this. * * @method Phaser.Physics.Arcade.Body#reset * @since 3.0.0 * * @param {number} x - The horizontal position to place the Game Object and Body. * @param {number} y - The vertical position to place the Game Object and Body. */ reset: function (x, y) { this.stop(); var gameObject = this.gameObject; gameObject.setPosition(x, y); gameObject.getTopLeft(this.position); this.prev.copy(this.position); this.rotation = gameObject.angle; this.preRotation = gameObject.angle; this.updateBounds(); this.updateCenter(); }, /** * Sets acceleration, velocity, and speed to zero. * * @method Phaser.Physics.Arcade.Body#stop * @since 3.0.0 * * @return {Phaser.Physics.Arcade.Body} This Body object. */ stop: function () { this.velocity.set(0); this.acceleration.set(0); this.speed = 0; this.angularVelocity = 0; this.angularAcceleration = 0; return this; }, /** * Copies the coordinates of this Body's edges into an object. * * @method Phaser.Physics.Arcade.Body#getBounds * @since 3.0.0 * * @param {ArcadeBodyBounds} obj - An object to copy the values into. * * @return {ArcadeBodyBounds} - An object with {x, y, right, bottom}. */ getBounds: function (obj) { obj.x = this.x; obj.y = this.y; obj.right = this.right; obj.bottom = this.bottom; return obj; }, /** * Tests if the coordinates are within this Body's boundary. * * @method Phaser.Physics.Arcade.Body#hitTest * @since 3.0.0 * * @param {number} x - The horizontal coordinate. * @param {number} y - The vertical coordinate. * * @return {boolean} True if (x, y) is within this Body. */ hitTest: function (x, y) { return (this.isCircle) ? CircleContains(this, x, y) : RectangleContains(this, x, y); }, /** * Whether this Body is touching a tile or the world boundary while moving down. * * @method Phaser.Physics.Arcade.Body#onFloor * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#blocked * * @return {boolean} True if touching. */ onFloor: function () { return this.blocked.down; }, /** * Whether this Body is touching a tile or the world boundary while moving up. * * @method Phaser.Physics.Arcade.Body#onCeiling * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#blocked * * @return {boolean} True if touching. */ onCeiling: function () { return this.blocked.up; }, /** * Whether this Body is touching a tile or the world boundary while moving left or right. * * @method Phaser.Physics.Arcade.Body#onWall * @since 3.0.0 * @see Phaser.Physics.Arcade.Body#blocked * * @return {boolean} True if touching. */ onWall: function () { return (this.blocked.left || this.blocked.right); }, /** * The absolute (non-negative) change in this Body's horizontal position from the previous step. * * @method Phaser.Physics.Arcade.Body#deltaAbsX * @since 3.0.0 * * @return {number} The delta value. */ deltaAbsX: function () { return (this._dx > 0) ? this._dx : -this._dx; }, /** * The absolute (non-negative) change in this Body's vertical position from the previous step. * * @method Phaser.Physics.Arcade.Body#deltaAbsY * @since 3.0.0 * * @return {number} The delta value. */ deltaAbsY: function () { return (this._dy > 0) ? this._dy : -this._dy; }, /** * The change in this Body's horizontal position from the previous step. * This value is set during the Body's update phase. * * @method Phaser.Physics.Arcade.Body#deltaX * @since 3.0.0 * * @return {number} The delta value. */ deltaX: function () { return this._dx; }, /** * The change in this Body's vertical position from the previous step. * This value is set during the Body's update phase. * * @method Phaser.Physics.Arcade.Body#deltaY * @since 3.0.0 * * @return {number} The delta value. */ deltaY: function () { return this._dy; }, /** * The change in this Body's rotation from the previous step, in degrees. * * @method Phaser.Physics.Arcade.Body#deltaZ * @since 3.0.0 * * @return {number} The delta value. */ deltaZ: function () { return this.rotation - this.preRotation; }, /** * Disables this Body and marks it for deletion by the simulation. * * @method Phaser.Physics.Arcade.Body#destroy * @since 3.0.0 */ destroy: function () { this.enable = false; this.world.pendingDestroy.set(this); }, /** * Draws this Body's boundary and velocity, if enabled. * * @method Phaser.Physics.Arcade.Body#drawDebug * @since 3.0.0 * * @param {Phaser.GameObjects.Graphics} graphic - The Graphics object to draw on. */ drawDebug: function (graphic) { var pos = this.position; var x = pos.x + this.halfWidth; var y = pos.y + this.halfHeight; if (this.debugShowBody) { graphic.lineStyle(1, this.debugBodyColor); if (this.isCircle) { graphic.strokeCircle(x, y, this.width / 2); } else { graphic.strokeRect(pos.x, pos.y, this.width, this.height); } } if (this.debugShowVelocity) { graphic.lineStyle(1, this.world.defaults.velocityDebugColor, 1); graphic.lineBetween(x, y, x + this.velocity.x / 2, y + this.velocity.y / 2); } }, /** * Whether this Body will be drawn to the debug display. * * @method Phaser.Physics.Arcade.Body#willDrawDebug * @since 3.0.0 * * @return {boolean} True if either `debugShowBody` or `debugShowVelocity` are enabled. */ willDrawDebug: function () { return (this.debugShowBody || this.debugShowVelocity); }, /** * Sets whether this Body collides with the world boundary. * * @method Phaser.Physics.Arcade.Body#setCollideWorldBounds * @since 3.0.0 * * @param {boolean} [value=true] - True (collisions) or false (no collisions). * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setCollideWorldBounds: function (value) { if (value === undefined) { value = true; } this.collideWorldBounds = value; return this; }, /** * Sets the Body's velocity. * * @method Phaser.Physics.Arcade.Body#setVelocity * @since 3.0.0 * * @param {number} x - The horizontal velocity, in pixels per second. * @param {number} [y=x] - The vertical velocity, in pixels per second. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setVelocity: function (x, y) { this.velocity.set(x, y); this.speed = Math.sqrt(x * x + y * y); return this; }, /** * Sets the Body's horizontal velocity. * * @method Phaser.Physics.Arcade.Body#setVelocityX * @since 3.0.0 * * @param {number} value - The velocity, in pixels per second. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setVelocityX: function (value) { this.velocity.x = value; var vx = value; var vy = this.velocity.y; this.speed = Math.sqrt(vx * vx + vy * vy); return this; }, /** * Sets the Body's vertical velocity. * * @method Phaser.Physics.Arcade.Body#setVelocityY * @since 3.0.0 * * @param {number} value - The velocity, in pixels per second. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setVelocityY: function (value) { this.velocity.y = value; var vx = this.velocity.x; var vy = value; this.speed = Math.sqrt(vx * vx + vy * vy); return this; }, /** * Sets the Body's maximum velocity. * * @method Phaser.Physics.Arcade.Body#setMaxVelocity * @since 3.10.0 * * @param {number} x - The horizontal velocity, in pixels per second. * @param {number} [y=x] - The vertical velocity, in pixels per second. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setMaxVelocity: function (x, y) { this.maxVelocity.set(x, y); return this; }, /** * Sets the Body's bounce. * * @method Phaser.Physics.Arcade.Body#setBounce * @since 3.0.0 * * @param {number} x - The horizontal bounce, relative to 1. * @param {number} y - The vertical bounce, relative to 1. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setBounce: function (x, y) { this.bounce.set(x, y); return this; }, /** * Sets the Body's horizontal bounce. * * @method Phaser.Physics.Arcade.Body#setBounceX * @since 3.0.0 * * @param {number} value - The bounce, relative to 1. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setBounceX: function (value) { this.bounce.x = value; return this; }, /** * Sets the Body's vertical bounce. * * @method Phaser.Physics.Arcade.Body#setBounceY * @since 3.0.0 * * @param {number} value - The bounce, relative to 1. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setBounceY: function (value) { this.bounce.y = value; return this; }, /** * Sets the Body's acceleration. * * @method Phaser.Physics.Arcade.Body#setAcceleration * @since 3.0.0 * * @param {number} x - The horizontal component, in pixels per second squared. * @param {number} y - The vertical component, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAcceleration: function (x, y) { this.acceleration.set(x, y); return this; }, /** * Sets the Body's horizontal acceleration. * * @method Phaser.Physics.Arcade.Body#setAccelerationX * @since 3.0.0 * * @param {number} value - The acceleration, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAccelerationX: function (value) { this.acceleration.x = value; return this; }, /** * Sets the Body's vertical acceleration. * * @method Phaser.Physics.Arcade.Body#setAccelerationY * @since 3.0.0 * * @param {number} value - The acceleration, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAccelerationY: function (value) { this.acceleration.y = value; return this; }, /** * Enables or disables drag. * * @method Phaser.Physics.Arcade.Body#setAllowDrag * @since 3.9.0 * @see Phaser.Physics.Arcade.Body#allowDrag * * @param {boolean} [value=true] - `true` to allow drag on this body, or `false` to disable it. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAllowDrag: function (value) { if (value === undefined) { value = true; } this.allowDrag = value; return this; }, /** * Enables or disables gravity's effect on this Body. * * @method Phaser.Physics.Arcade.Body#setAllowGravity * @since 3.9.0 * @see Phaser.Physics.Arcade.Body#allowGravity * * @param {boolean} [value=true] - `true` to allow gravity on this body, or `false` to disable it. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAllowGravity: function (value) { if (value === undefined) { value = true; } this.allowGravity = value; return this; }, /** * Enables or disables rotation. * * @method Phaser.Physics.Arcade.Body#setAllowRotation * @since 3.9.0 * @see Phaser.Physics.Arcade.Body#allowRotation * * @param {boolean} [value=true] - `true` to allow rotation on this body, or `false` to disable it. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAllowRotation: function (value) { if (value === undefined) { value = true; } this.allowRotation = value; return this; }, /** * Sets the Body's drag. * * @method Phaser.Physics.Arcade.Body#setDrag * @since 3.0.0 * * @param {number} x - The horizontal component, in pixels per second squared. * @param {number} y - The vertical component, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setDrag: function (x, y) { this.drag.set(x, y); return this; }, /** * Sets the Body's horizontal drag. * * @method Phaser.Physics.Arcade.Body#setDragX * @since 3.0.0 * * @param {number} value - The drag, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setDragX: function (value) { this.drag.x = value; return this; }, /** * Sets the Body's vertical drag. * * @method Phaser.Physics.Arcade.Body#setDragY * @since 3.0.0 * * @param {number} value - The drag, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setDragY: function (value) { this.drag.y = value; return this; }, /** * Sets the Body's gravity. * * @method Phaser.Physics.Arcade.Body#setGravity * @since 3.0.0 * * @param {number} x - The horizontal component, in pixels per second squared. * @param {number} y - The vertical component, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setGravity: function (x, y) { this.gravity.set(x, y); return this; }, /** * Sets the Body's horizontal gravity. * * @method Phaser.Physics.Arcade.Body#setGravityX * @since 3.0.0 * * @param {number} value - The gravity, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setGravityX: function (value) { this.gravity.x = value; return this; }, /** * Sets the Body's vertical gravity. * * @method Phaser.Physics.Arcade.Body#setGravityY * @since 3.0.0 * * @param {number} value - The gravity, in pixels per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setGravityY: function (value) { this.gravity.y = value; return this; }, /** * Sets the Body's friction. * * @method Phaser.Physics.Arcade.Body#setFriction * @since 3.0.0 * * @param {number} x - The horizontal component, relative to 1. * @param {number} y - The vertical component, relative to 1. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setFriction: function (x, y) { this.friction.set(x, y); return this; }, /** * Sets the Body's horizontal friction. * * @method Phaser.Physics.Arcade.Body#setFrictionX * @since 3.0.0 * * @param {number} value - The friction value, relative to 1. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setFrictionX: function (value) { this.friction.x = value; return this; }, /** * Sets the Body's vertical friction. * * @method Phaser.Physics.Arcade.Body#setFrictionY * @since 3.0.0 * * @param {number} value - The friction value, relative to 1. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setFrictionY: function (value) { this.friction.y = value; return this; }, /** * Sets the Body's angular velocity. * * @method Phaser.Physics.Arcade.Body#setAngularVelocity * @since 3.0.0 * * @param {number} value - The velocity, in degrees per second. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAngularVelocity: function (value) { this.angularVelocity = value; return this; }, /** * Sets the Body's angular acceleration. * * @method Phaser.Physics.Arcade.Body#setAngularAcceleration * @since 3.0.0 * * @param {number} value - The acceleration, in degrees per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAngularAcceleration: function (value) { this.angularAcceleration = value; return this; }, /** * Sets the Body's angular drag. * * @method Phaser.Physics.Arcade.Body#setAngularDrag * @since 3.0.0 * * @param {number} value - The drag, in degrees per second squared. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setAngularDrag: function (value) { this.angularDrag = value; return this; }, /** * Sets the Body's mass. * * @method Phaser.Physics.Arcade.Body#setMass * @since 3.0.0 * * @param {number} value - The mass value, relative to 1. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setMass: function (value) { this.mass = value; return this; }, /** * Sets the Body's `immovable` property. * * @method Phaser.Physics.Arcade.Body#setImmovable * @since 3.0.0 * * @param {boolean} [value=true] - The value to assign to `immovable`. * * @return {Phaser.Physics.Arcade.Body} This Body object. */ setImmovable: function (value) { if (value === undefined) { value = true; } this.immovable = value; return this; }, /** * The Body's horizontal position (left edge). * * @name Phaser.Physics.Arcade.Body#x * @type {number} * @since 3.0.0 */ x: { get: function () { return this.position.x; }, set: function (value) { this.position.x = value; } }, /** * The Body's vertical position (top edge). * * @name Phaser.Physics.Arcade.Body#y * @type {number} * @since 3.0.0 */ y: { get: function () { return this.position.y; }, set: function (value) { this.position.y = value; } }, /** * The left edge of the Body's boundary. Identical to x. * * @name Phaser.Physics.Arcade.Body#left * @type {number} * @readOnly * @since 3.0.0 */ left: { get: function () { return this.position.x; } }, /** * The right edge of the Body's boundary. * * @name Phaser.Physics.Arcade.Body#right * @type {number} * @readOnly * @since 3.0.0 */ right: { get: function () { return this.position.x + this.width; } }, /** * The top edge of the Body's boundary. Identical to y. * * @name Phaser.Physics.Arcade.Body#top * @type {number} * @readOnly * @since 3.0.0 */ top: { get: function () { return this.position.y; } }, /** * The bottom edge of this Body's boundary. * * @name Phaser.Physics.Arcade.Body#bottom * @type {number} * @readOnly * @since 3.0.0 */ bottom: { get: function () { return this.position.y + this.height; } } }); module.exports = Body;