2018-02-12 16:01:20 +00:00
|
|
|
/**
|
|
|
|
* @author Richard Davey <rich@photonstorm.com>
|
|
|
|
* @copyright 2018 Photon Storm Ltd.
|
|
|
|
* @license {@link https://github.com/photonstorm/phaser/blob/master/license.txt|MIT License}
|
|
|
|
*/
|
|
|
|
|
2017-11-09 04:00:56 +00:00
|
|
|
var ArcadeSprite = require('./ArcadeSprite');
|
|
|
|
var Class = require('../../utils/Class');
|
|
|
|
var CONST = require('./const');
|
|
|
|
var GetFastValue = require('../../utils/object/GetFastValue');
|
|
|
|
var Group = require('../../gameobjects/group/Group');
|
2018-08-01 17:01:36 +00:00
|
|
|
var IsPlainObject = require('../../utils/object/IsPlainObject');
|
2017-11-09 04:00:56 +00:00
|
|
|
|
2018-03-21 13:15:25 +00:00
|
|
|
/**
|
|
|
|
* @typedef {object} PhysicsGroupConfig
|
|
|
|
* @extends GroupConfig
|
|
|
|
*
|
2018-04-24 00:48:15 +00:00
|
|
|
* @property {boolean} [collideWorldBounds=false] - Sets {@link Phaser.Physics.Arcade.Body#collideWorldBounds}.
|
|
|
|
* @property {number} [accelerationX=0] - Sets {@link Phaser.Physics.Arcade.Body#acceleration acceleration.x}.
|
|
|
|
* @property {number} [accelerationY=0] - Sets {@link Phaser.Physics.Arcade.Body#acceleration acceleration.y}.
|
2018-05-15 14:59:02 +00:00
|
|
|
* @property {boolean} [allowDrag=true] - Sets {@link Phaser.Physics.Arcade.Body#allowDrag}.
|
|
|
|
* @property {boolean} [allowGravity=true] - Sets {@link Phaser.Physics.Arcade.Body#allowGravity}.
|
|
|
|
* @property {boolean} [allowRotation=true] - Sets {@link Phaser.Physics.Arcade.Body#allowRotation}.
|
2018-04-24 00:48:15 +00:00
|
|
|
* @property {number} [bounceX=0] - Sets {@link Phaser.Physics.Arcade.Body#bounce bounce.x}.
|
|
|
|
* @property {number} [bounceY=0] - Sets {@link Phaser.Physics.Arcade.Body#bounce bounce.y}.
|
|
|
|
* @property {number} [dragX=0] - Sets {@link Phaser.Physics.Arcade.Body#drag drag.x}.
|
|
|
|
* @property {number} [dragY=0] - Sets {@link Phaser.Physics.Arcade.Body#drag drag.y}.
|
2018-09-26 17:25:45 +00:00
|
|
|
* @property {boolean} [enable=true] - Sets {@link Phaser.Physics.Arcade.Body#enable enable}.
|
2018-04-24 00:48:15 +00:00
|
|
|
* @property {number} [gravityX=0] - Sets {@link Phaser.Physics.Arcade.Body#gravity gravity.x}.
|
|
|
|
* @property {number} [gravityY=0] - Sets {@link Phaser.Physics.Arcade.Body#gravity gravity.y}.
|
|
|
|
* @property {number} [frictionX=0] - Sets {@link Phaser.Physics.Arcade.Body#friction friction.x}.
|
|
|
|
* @property {number} [frictionY=0] - Sets {@link Phaser.Physics.Arcade.Body#friction friction.y}.
|
|
|
|
* @property {number} [velocityX=0] - Sets {@link Phaser.Physics.Arcade.Body#velocity velocity.x}.
|
|
|
|
* @property {number} [velocityY=0] - Sets {@link Phaser.Physics.Arcade.Body#velocity velocity.y}.
|
|
|
|
* @property {number} [angularVelocity=0] - Sets {@link Phaser.Physics.Arcade.Body#angularVelocity}.
|
|
|
|
* @property {number} [angularAcceleration=0] - Sets {@link Phaser.Physics.Arcade.Body#angularAcceleration}.
|
|
|
|
* @property {number} [angularDrag=0] - Sets {@link Phaser.Physics.Arcade.Body#angularDrag}.
|
|
|
|
* @property {number} [mass=0] - Sets {@link Phaser.Physics.Arcade.Body#mass}.
|
|
|
|
* @property {boolean} [immovable=false] - Sets {@link Phaser.Physics.Arcade.Body#immovable}.
|
2018-03-21 13:15:25 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @typedef {object} PhysicsGroupDefaults
|
|
|
|
*
|
2018-09-26 19:25:09 +00:00
|
|
|
* @property {boolean} setCollideWorldBounds - As {@link Phaser.Physics.Arcade.Body#setCollideWorldBounds}.
|
|
|
|
* @property {number} setAccelerationX - As {@link Phaser.Physics.Arcade.Body#setAccelerationX}.
|
|
|
|
* @property {number} setAccelerationY - As {@link Phaser.Physics.Arcade.Body#setAccelerationY}.
|
|
|
|
* @property {boolean} setAllowDrag - As {@link Phaser.Physics.Arcade.Body#setAllowDrag}.
|
|
|
|
* @property {boolean} setAllowGravity - As {@link Phaser.Physics.Arcade.Body#setAllowGravity}.
|
|
|
|
* @property {boolean} setAllowRotation - As {@link Phaser.Physics.Arcade.Body#setAllowRotation}.
|
|
|
|
* @property {number} setBounceX - As {@link Phaser.Physics.Arcade.Body#setBounceX}.
|
|
|
|
* @property {number} setBounceY - As {@link Phaser.Physics.Arcade.Body#setBounceY}.
|
|
|
|
* @property {number} setDragX - As {@link Phaser.Physics.Arcade.Body#setDragX}.
|
|
|
|
* @property {number} setDragY - As {@link Phaser.Physics.Arcade.Body#setDragY}.
|
2018-09-29 21:09:05 +00:00
|
|
|
* @property {boolean} setEnable - As {@link Phaser.Physics.Arcade.Body#setEnable}.
|
2018-09-26 19:25:09 +00:00
|
|
|
* @property {number} setGravityX - As {@link Phaser.Physics.Arcade.Body#setGravityX}.
|
|
|
|
* @property {number} setGravityY - As {@link Phaser.Physics.Arcade.Body#setGravityY}.
|
|
|
|
* @property {number} setFrictionX - As {@link Phaser.Physics.Arcade.Body#setFrictionX}.
|
|
|
|
* @property {number} setFrictionY - As {@link Phaser.Physics.Arcade.Body#setFrictionY}.
|
|
|
|
* @property {number} setVelocityX - As {@link Phaser.Physics.Arcade.Body#setVelocityX}.
|
|
|
|
* @property {number} setVelocityY - As {@link Phaser.Physics.Arcade.Body#setVelocityY}.
|
|
|
|
* @property {number} setAngularVelocity - As {@link Phaser.Physics.Arcade.Body#setAngularVelocity}.
|
|
|
|
* @property {number} setAngularAcceleration - As {@link Phaser.Physics.Arcade.Body#setAngularAcceleration}.
|
|
|
|
* @property {number} setAngularDrag - As {@link Phaser.Physics.Arcade.Body#setAngularDrag}.
|
|
|
|
* @property {number} setMass - As {@link Phaser.Physics.Arcade.Body#setMass}.
|
|
|
|
* @property {boolean} setImmovable - As {@link Phaser.Physics.Arcade.Body#setImmovable}.
|
2018-03-21 13:15:25 +00:00
|
|
|
*/
|
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
|
|
|
* @classdesc
|
|
|
|
* An Arcade Physics Group object.
|
2018-03-21 13:15:25 +00:00
|
|
|
*
|
2018-06-13 16:41:50 +00:00
|
|
|
* All Game Objects created by this Group will automatically be given dynamic Arcade Physics bodies.
|
|
|
|
*
|
|
|
|
* Its static counterpart is {@link Phaser.Physics.Arcade.StaticGroup}.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @class Group
|
|
|
|
* @extends Phaser.GameObjects.Group
|
2018-10-10 09:49:13 +00:00
|
|
|
* @memberof Phaser.Physics.Arcade
|
2018-02-09 03:44:23 +00:00
|
|
|
* @constructor
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-09-26 19:25:09 +00:00
|
|
|
* @param {Phaser.Physics.Arcade.World} world - The physics simulation.
|
|
|
|
* @param {Phaser.Scene} scene - The scene this group belongs to.
|
|
|
|
* @param {(Phaser.GameObjects.GameObject[]|PhysicsGroupConfig|GroupCreateConfig)} [children] - Game Objects to add to this group; or the `config` argument.
|
|
|
|
* @param {PhysicsGroupConfig|GroupCreateConfig} [config] - Settings for this group.
|
2018-02-09 03:44:23 +00:00
|
|
|
*/
|
2017-11-09 04:00:56 +00:00
|
|
|
var PhysicsGroup = new Class({
|
|
|
|
|
|
|
|
Extends: Group,
|
|
|
|
|
|
|
|
initialize:
|
|
|
|
|
|
|
|
function PhysicsGroup (world, scene, children, config)
|
|
|
|
{
|
2018-08-01 17:01:36 +00:00
|
|
|
if (!children && !config)
|
2017-11-09 04:00:56 +00:00
|
|
|
{
|
2018-08-01 17:01:36 +00:00
|
|
|
config = {
|
|
|
|
createCallback: this.createCallbackHandler,
|
|
|
|
removeCallback: this.removeCallbackHandler
|
|
|
|
};
|
|
|
|
}
|
|
|
|
else if (IsPlainObject(children))
|
|
|
|
{
|
|
|
|
// children is a plain object, so swizzle them:
|
2017-11-09 04:00:56 +00:00
|
|
|
config = children;
|
|
|
|
children = null;
|
2018-08-01 17:01:36 +00:00
|
|
|
|
|
|
|
config.createCallback = this.createCallbackHandler;
|
|
|
|
config.removeCallback = this.removeCallbackHandler;
|
2017-11-09 04:00:56 +00:00
|
|
|
}
|
2018-08-01 17:01:36 +00:00
|
|
|
else if (Array.isArray(children) && IsPlainObject(children[0]))
|
2017-11-09 04:00:56 +00:00
|
|
|
{
|
2018-08-01 17:01:36 +00:00
|
|
|
// children is an array of plain objects
|
|
|
|
config = children;
|
|
|
|
children = null;
|
|
|
|
|
|
|
|
config.forEach(function (singleConfig)
|
|
|
|
{
|
|
|
|
singleConfig.createCallback = this.createCallbackHandler;
|
|
|
|
singleConfig.removeCallback = this.removeCallbackHandler;
|
|
|
|
});
|
2017-11-09 04:00:56 +00:00
|
|
|
}
|
2018-10-16 23:13:18 +00:00
|
|
|
else
|
|
|
|
{
|
|
|
|
// config is not defined and children is not a plain object nor an array of plain objects
|
|
|
|
config = {
|
|
|
|
createCallback: this.createCallbackHandler,
|
|
|
|
removeCallback: this.removeCallbackHandler
|
|
|
|
}
|
|
|
|
}
|
2017-11-09 04:00:56 +00:00
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-09-26 19:25:09 +00:00
|
|
|
* The physics simulation.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @name Phaser.Physics.Arcade.Group#world
|
|
|
|
* @type {Phaser.Physics.Arcade.World}
|
|
|
|
* @since 3.0.0
|
|
|
|
*/
|
2017-11-09 04:00:56 +00:00
|
|
|
this.world = world;
|
|
|
|
|
2018-04-24 00:48:15 +00:00
|
|
|
/**
|
|
|
|
* The class to create new group members from.
|
2018-06-13 16:41:50 +00:00
|
|
|
* This should be ArcadeImage, ArcadeSprite, or a class extending one of those.
|
2018-04-24 00:48:15 +00:00
|
|
|
*
|
|
|
|
* @name Phaser.Physics.Arcade.Group#classType
|
2018-06-13 16:41:50 +00:00
|
|
|
* @type {(Phaser.Physics.Arcade.Image|Phaser.Physics.Arcade.Sprite)}
|
2018-04-24 00:48:15 +00:00
|
|
|
* @default ArcadeSprite
|
|
|
|
*/
|
2017-11-16 00:42:03 +00:00
|
|
|
config.classType = GetFastValue(config, 'classType', ArcadeSprite);
|
2017-11-09 04:00:56 +00:00
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-09-26 19:25:09 +00:00
|
|
|
* The physics type of the Group's members.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @name Phaser.Physics.Arcade.Group#physicsType
|
|
|
|
* @type {integer}
|
2018-06-13 16:41:50 +00:00
|
|
|
* @default DYNAMIC_BODY
|
2018-02-09 03:44:23 +00:00
|
|
|
* @since 3.0.0
|
|
|
|
*/
|
2017-11-09 16:31:57 +00:00
|
|
|
this.physicsType = CONST.DYNAMIC_BODY;
|
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-06-13 16:41:50 +00:00
|
|
|
* Default physics properties applied to Game Objects added to the Group or created by the Group. Derived from the `config` argument.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @name Phaser.Physics.Arcade.Group#defaults
|
2018-03-21 13:15:25 +00:00
|
|
|
* @type {PhysicsGroupDefaults}
|
2018-02-09 03:44:23 +00:00
|
|
|
* @since 3.0.0
|
|
|
|
*/
|
2017-11-09 04:00:56 +00:00
|
|
|
this.defaults = {
|
|
|
|
setCollideWorldBounds: GetFastValue(config, 'collideWorldBounds', false),
|
|
|
|
setAccelerationX: GetFastValue(config, 'accelerationX', 0),
|
|
|
|
setAccelerationY: GetFastValue(config, 'accelerationY', 0),
|
2018-05-15 14:59:02 +00:00
|
|
|
setAllowDrag: GetFastValue(config, 'allowDrag', true),
|
|
|
|
setAllowGravity: GetFastValue(config, 'allowGravity', true),
|
|
|
|
setAllowRotation: GetFastValue(config, 'allowRotation', true),
|
2017-11-09 04:00:56 +00:00
|
|
|
setBounceX: GetFastValue(config, 'bounceX', 0),
|
|
|
|
setBounceY: GetFastValue(config, 'bounceY', 0),
|
|
|
|
setDragX: GetFastValue(config, 'dragX', 0),
|
|
|
|
setDragY: GetFastValue(config, 'dragY', 0),
|
2018-09-26 17:25:45 +00:00
|
|
|
setEnable: GetFastValue(config, 'enable', true),
|
2017-11-09 04:00:56 +00:00
|
|
|
setGravityX: GetFastValue(config, 'gravityX', 0),
|
|
|
|
setGravityY: GetFastValue(config, 'gravityY', 0),
|
|
|
|
setFrictionX: GetFastValue(config, 'frictionX', 0),
|
|
|
|
setFrictionY: GetFastValue(config, 'frictionY', 0),
|
|
|
|
setVelocityX: GetFastValue(config, 'velocityX', 0),
|
|
|
|
setVelocityY: GetFastValue(config, 'velocityY', 0),
|
|
|
|
setAngularVelocity: GetFastValue(config, 'angularVelocity', 0),
|
|
|
|
setAngularAcceleration: GetFastValue(config, 'angularAcceleration', 0),
|
|
|
|
setAngularDrag: GetFastValue(config, 'angularDrag', 0),
|
|
|
|
setMass: GetFastValue(config, 'mass', 1),
|
2017-11-09 16:31:57 +00:00
|
|
|
setImmovable: GetFastValue(config, 'immovable', false)
|
2017-11-09 04:00:56 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
Group.call(this, scene, children, config);
|
|
|
|
},
|
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-06-13 16:41:50 +00:00
|
|
|
* Enables a Game Object's Body and assigns `defaults`. Called when a Group member is added or created.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
2018-04-18 12:29:22 +00:00
|
|
|
* @method Phaser.Physics.Arcade.Group#createCallbackHandler
|
2018-02-09 03:44:23 +00:00
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-09-26 19:25:09 +00:00
|
|
|
* @param {Phaser.GameObjects.GameObject} child - The Game Object being added.
|
2018-02-09 03:44:23 +00:00
|
|
|
*/
|
2018-04-18 12:29:22 +00:00
|
|
|
createCallbackHandler: function (child)
|
2017-11-09 04:00:56 +00:00
|
|
|
{
|
|
|
|
if (!child.body)
|
|
|
|
{
|
2017-11-09 16:31:57 +00:00
|
|
|
this.world.enableBody(child, CONST.DYNAMIC_BODY);
|
2017-11-09 04:00:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
var body = child.body;
|
|
|
|
|
|
|
|
for (var key in this.defaults)
|
|
|
|
{
|
|
|
|
body[key](this.defaults[key]);
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-06-13 16:41:50 +00:00
|
|
|
* Disables a Game Object's Body. Called when a Group member is removed.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
2018-04-18 12:29:22 +00:00
|
|
|
* @method Phaser.Physics.Arcade.Group#removeCallbackHandler
|
2018-02-09 03:44:23 +00:00
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-09-26 19:25:09 +00:00
|
|
|
* @param {Phaser.GameObjects.GameObject} child - The Game Object being removed.
|
2018-02-09 03:44:23 +00:00
|
|
|
*/
|
2018-04-18 12:29:22 +00:00
|
|
|
removeCallbackHandler: function (child)
|
2017-11-09 04:00:56 +00:00
|
|
|
{
|
|
|
|
if (child.body)
|
|
|
|
{
|
|
|
|
this.world.disableBody(child);
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-06-13 16:41:50 +00:00
|
|
|
* Sets the velocity of each Group member.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Physics.Arcade.Group#setVelocity
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-09-26 19:25:09 +00:00
|
|
|
* @param {number} x - The horizontal velocity.
|
|
|
|
* @param {number} y - The vertical velocity.
|
|
|
|
* @param {number} [step=0] - The velocity increment. When set, the first member receives velocity (x, y), the second (x + step, y + step), and so on.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @return {Phaser.Physics.Arcade.Group} This Physics Group object.
|
|
|
|
*/
|
2017-11-09 04:00:56 +00:00
|
|
|
setVelocity: function (x, y, step)
|
|
|
|
{
|
|
|
|
if (step === undefined) { step = 0; }
|
|
|
|
|
|
|
|
var items = this.getChildren();
|
|
|
|
|
|
|
|
for (var i = 0; i < items.length; i++)
|
|
|
|
{
|
|
|
|
items[i].body.velocity.set(x + (i * step), y + (i * step));
|
|
|
|
}
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-06-13 16:41:50 +00:00
|
|
|
* Sets the horizontal velocity of each Group member.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Physics.Arcade.Group#setVelocityX
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-09-26 19:25:09 +00:00
|
|
|
* @param {number} value - The velocity value.
|
|
|
|
* @param {number} [step=0] - The velocity increment. When set, the first member receives velocity (x), the second (x + step), and so on.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @return {Phaser.Physics.Arcade.Group} This Physics Group object.
|
|
|
|
*/
|
2017-11-09 04:00:56 +00:00
|
|
|
setVelocityX: function (value, step)
|
|
|
|
{
|
|
|
|
if (step === undefined) { step = 0; }
|
|
|
|
|
|
|
|
var items = this.getChildren();
|
|
|
|
|
|
|
|
for (var i = 0; i < items.length; i++)
|
|
|
|
{
|
|
|
|
items[i].body.velocity.x = value + (i * step);
|
|
|
|
}
|
|
|
|
|
|
|
|
return this;
|
|
|
|
},
|
|
|
|
|
2018-02-09 03:44:23 +00:00
|
|
|
/**
|
2018-06-13 16:41:50 +00:00
|
|
|
* Sets the vertical velocity of each Group member.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @method Phaser.Physics.Arcade.Group#setVelocityY
|
|
|
|
* @since 3.0.0
|
|
|
|
*
|
2018-09-26 19:25:09 +00:00
|
|
|
* @param {number} value - The velocity value.
|
|
|
|
* @param {number} [step=0] - The velocity increment. When set, the first member receives velocity (y), the second (y + step), and so on.
|
2018-02-09 03:44:23 +00:00
|
|
|
*
|
|
|
|
* @return {Phaser.Physics.Arcade.Group} This Physics Group object.
|
|
|
|
*/
|
2017-11-09 04:00:56 +00:00
|
|
|
setVelocityY: function (value, step)
|
|
|
|
{
|
|
|
|
if (step === undefined) { step = 0; }
|
|
|
|
|
|
|
|
var items = this.getChildren();
|
|
|
|
|
|
|
|
for (var i = 0; i < items.length; i++)
|
|
|
|
{
|
|
|
|
items[i].body.velocity.y = value + (i * step);
|
|
|
|
}
|
|
|
|
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
});
|
|
|
|
|
|
|
|
module.exports = PhysicsGroup;
|